home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 001a / gt1700_1.zip / GT1600.DOC < prev    next >
Text File  |  1991-10-28  |  218KB  |  5,420 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                  GT POWER 16.00
  10.          Copyright (c) 1985, 1990: by P & M Software Co.
  11.                   All rights reserved.
  12.  
  13.                                 December 6, 1990
  14.  
  15.  
  16.      GT POWER,  or just GT for short,  is a communications program for  IBM
  17.      Personal Computers and compatible units.  P & M Software Co.  reserves
  18.      the  copyright to this program and all related materials.  The user is
  19.      granted a license to use the program  and  is  encouraged  to  make  a
  20.      donation  if  the  program  is  found  to  be  useful.   $70  U.S.  is
  21.      recommended.  Send the donations to:
  22.  
  23.  
  24.  
  25.                              P&M Software Company
  26.                              3104 E. Camelback Rd.
  27.                              Suite #503
  28.                              Phoenix, AZ    85016
  29.                              U. S. A.
  30.  
  31.  
  32.  
  33.                                   Telephones
  34.                                   ----------
  35.                  Voice: (602) 897-9557
  36.                  Modem: (602) 897-9549
  37.  
  38.  
  39.  
  40.  
  41.      For  further information about the GT POWER registration plan,  please
  42.      read the file called REGISTER.DOC,  which comes with this program.  It
  43.      outlines the benefits of full registration.
  44.  
  45.      In addition, the user is granted the right to make unlimited copies of
  46.      the program and to distribute these copies as he/she  desires,  EXCEPT
  47.      that  P&M  Software  Co.  reserves  the  SOLE  right to distribute the
  48.      program for PROFIT.  If the user distributes the product, the user may
  49.      collect for a duplication charge, not to exceed $10 per copy.
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                     - 1 -
  60.  
  61.  
  62.                                 Table of Contents
  63.                                 -----------------
  64.      Credit Where Credit is Due  . . . . . . . . . . . . . . . . .  4
  65.      Features  . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  66.      Functional Overview . . . . . . . . . . . . . . . . . . . . .  9
  67.      Installation Notes  . . . . . . . . . . . . . . . . . . . . . 12
  68.          External Protocols  . . . . . . . . . . . . . . . . . . . 12
  69.          Important . . . . . . . . . . . . . . . . . . . . . . . . 14
  70.          Environment Usage . . . . . . . . . . . . . . . . . . . . 15
  71.              DOS 3.2 . . . . . . . . . . . . . . . . . . . . . . . 15
  72.              DOS 3.3 . . . . . . . . . . . . . . . . . . . . . . . 15
  73.              General Notes On DOS  . . . . . . . . . . . . . . . . 16
  74.          Modem Result Codes  . . . . . . . . . . . . . . . . . . . 16
  75.          Multiple Result Codes . . . . . . . . . . . . . . . . . . 17
  76.      First Time Usage  . . . . . . . . . . . . . . . . . . . . . . 17
  77.      Command Line Usage  . . . . . . . . . . . . . . . . . . . . . 19
  78.      RAM Disk Usage  . . . . . . . . . . . . . . . . . . . . . . . 22
  79.      Coping With A Floppy Based System . . . . . . . . . . . . . . 23
  80.      Computer To Computer Without Modems . . . . . . . . . . . . . 25
  81.      Alt-Command Descriptions  . . . . . . . . . . . . . . . . . . 26
  82.          ASCII Transmit  . . . . . . . . . . . . . . . . . . . . . 26
  83.          BREAK Signal  . . . . . . . . . . . . . . . . . . . . . . 26
  84.          Capture Mode  . . . . . . . . . . . . . . . . . . . . . . 26
  85.              Capture Header  . . . . . . . . . . . . . . . . . . . 27
  86.          Phone Directory . . . . . . . . . . . . . . . . . . . . . 27
  87.              Dialing The Modem . . . . . . . . . . . . . . . . . . 27
  88.          Half Duplex . . . . . . . . . . . . . . . . . . . . . . . 27
  89.          Take A Time Fix . . . . . . . . . . . . . . . . . . . . . 27
  90.          Redial Previous Number  . . . . . . . . . . . . . . . . . 28
  91.          The HELP Screen . . . . . . . . . . . . . . . . . . . . . 28
  92.          Custom Configure The Program  . . . . . . . . . . . . . . 28
  93.          Program Version And Serial number . . . . . . . . . . . . 28
  94.          Erase A File  . . . . . . . . . . . . . . . . . . . . . . 28
  95.          Disk Directory Listing  . . . . . . . . . . . . . . . . . 28
  96.          Macro Keys  . . . . . . . . . . . . . . . . . . . . . . . 28
  97.              Enhanced Keyboard Support . . . . . . . . . . . . . . 28
  98.              Keyboard Macros . . . . . . . . . . . . . . . . . . . 29
  99.              Execute A DOS Command . . . . . . . . . . . . . . . . 29
  100.              Start Recording Keystrokes  . . . . . . . . . . . . . 30
  101.              Stop Recording Keystrokes . . . . . . . . . . . . . . 30
  102.              Playback Previously Recorded Keystrokes . . . . . . . 30
  103.              Toggle Status Line Update . . . . . . . . . . . . . . 30
  104.              Extended Keys In Macros . . . . . . . . . . . . . . . 30
  105.          Change Logged Disk Drive  . . . . . . . . . . . . . . . . 31
  106.          Sort Phone Directory  . . . . . . . . . . . . . . . . . . 31
  107.          Print A File  . . . . . . . . . . . . . . . . . . . . . . 31
  108.          Hang-up The Telephone . . . . . . . . . . . . . . . . . . 31
  109.          Download A File . . . . . . . . . . . . . . . . . . . . . 31
  110.              Use <PgDn> Key  . . . . . . . . . . . . . . . . . . . 32
  111.              DOS Path & External Protocols . . . . . . . . . . . . 32
  112.          Change Communications Parameters  . . . . . . . . . . . . 32
  113.          Upload A File . . . . . . . . . . . . . . . . . . . . . . 32
  114.              The Pick List . . . . . . . . . . . . . . . . . . . . 32
  115.              Use <PgUp> Key  . . . . . . . . . . . . . . . . . . . 33
  116.  
  117.  
  118.                                     - 2 -
  119.  
  120.  
  121.              DOS Path & External Protocols . . . . . . . . . . . . 33
  122.          Report Time Used  . . . . . . . . . . . . . . . . . . . . 33
  123.          View A File . . . . . . . . . . . . . . . . . . . . . . . 33
  124.          Clear Screen  . . . . . . . . . . . . . . . . . . . . . . 33
  125.          Exit The Program  . . . . . . . . . . . . . . . . . . . . 33
  126.          Copy A File . . . . . . . . . . . . . . . . . . . . . . . 33
  127.          Toggle Monitor Mode . . . . . . . . . . . . . . . . . . . 33
  128.          Shell To DOS  . . . . . . . . . . . . . . . . . . . . . . 33
  129.          Screen Dump . . . . . . . . . . . . . . . . . . . . . . . 33
  130.          Execute A Script  . . . . . . . . . . . . . . . . . . . . 33
  131.              Macro To Execute A Script . . . . . . . . . . . . . . 34
  132.          Suspend Capture Mode  . . . . . . . . . . . . . . . . . . 34
  133.          Force Checksum Xmodem . . . . . . . . . . . . . . . . . . 34
  134.          Circular Dialing Queue  . . . . . . . . . . . . . . . . . 34
  135.          Split Screen Mode . . . . . . . . . . . . . . . . . . . . 34
  136.          Review Capture Mode . . . . . . . . . . . . . . . . . . . 34
  137.          Quiet Mode  . . . . . . . . . . . . . . . . . . . . . . . 34
  138.          Manual LOG Entry  . . . . . . . . . . . . . . . . . . . . 35
  139.          Enter Host Mode . . . . . . . . . . . . . . . . . . . . . 35
  140.          Toggle The Printer  . . . . . . . . . . . . . . . . . . . 35
  141.          Transparent Mode  . . . . . . . . . . . . . . . . . . . . 35
  142.          25 Line Operation . . . . . . . . . . . . . . . . . . . . 35
  143.      Phone Directory Commands  . . . . . . . . . . . . . . . . . . 36
  144.          Dial Scripts  . . . . . . . . . . . . . . . . . . . . . . 38
  145.              An example Dial Script  . . . . . . . . . . . . . . . 39
  146.          Script Menus  . . . . . . . . . . . . . . . . . . . . . . 39
  147.          Text Editing Keys . . . . . . . . . . . . . . . . . . . . 39
  148.      Host Mode . . . . . . . . . . . . . . . . . . . . . . . . . . 41
  149.          GT Netmail System . . . . . . . . . . . . . . . . . . . . 41
  150.      Script Language . . . . . . . . . . . . . . . . . . . . . . . 42
  151.          Script Line Labels  . . . . . . . . . . . . . . . . . . . 43
  152.          Script Command Summary  . . . . . . . . . . . . . . . . . 43
  153.          Script Command Descriptions . . . . . . . . . . . . . . . 46
  154.      Appendix  . . . . . . . . . . . . . . . . . . . . . . . . . . 69
  155.          Status Line Indicators  . . . . . . . . . . . . . . . . . 69
  156.          System Files  . . . . . . . . . . . . . . . . . . . . . . 70
  157.          Configuration File Layout . . . . . . . . . . . . . . . . 72
  158.          Configuration File Defaults . . . . . . . . . . . . . . . 76
  159.          Color Number Table  . . . . . . . . . . . . . . . . . . . 79
  160.          ANSI Emulation - Received Characters  . . . . . . . . . . 80
  161.          ANSI Emulation - Transmitted Characters . . . . . . . . . 82
  162.          Support For USRobotics Courier 2400 . . . . . . . . . . . 83
  163.          Support For USRobotics Courier HST - 9600 Baud  . . . . . 84
  164.              Modem Init String . . . . . . . . . . . . . . . . . . 84
  165.              Configuration Setup . . . . . . . . . . . . . . . . . 84
  166.              19200 Baud Rate . . . . . . . . . . . . . . . . . . . 84
  167.              Fixed DTE Operation . . . . . . . . . . . . . . . . . 84
  168.          Hayes 2400 Init String  . . . . . . . . . . . . . . . . . 86
  169.          Help For IBM Modems . . . . . . . . . . . . . . . . . . . 87
  170.      Registration Message  . . . . . . . . . . . . . . . . . . . . 88
  171.      Registration Form . . . . . . . . . . . . . . . . . . . . . . 89
  172.  
  173.  
  174.  
  175.  
  176.  
  177.                                     - 3 -
  178.  
  179.  
  180.      Credit Where Credit is Due.
  181.      ---------------------------
  182.      I want to thank the following for their support and encouragement.
  183.  
  184.            Donald Fletcher       John Perry            Perry Alexander
  185.            Bryan Pike            John Della-Torre      Ken Thompson
  186.            Jack Hazel            Raymond Wood          Chris Smith
  187.            Tom Scallorn          Gene Newcomb          Stephen Deplater
  188.            Harry Green           Oliver Bell           John Fisher
  189.            Cory Wright           Ed Bragg              Mike Focke
  190.            Mark Shasby           Terry Dansey          Bob Camp
  191.            Ed Cavender           Keith Coyne           Jim Kreyling
  192.  
  193.  
  194.      And all of the users of GT POWER, and especially the 100 or so folks
  195.      that helped beta test version 16.00!
  196.  
  197.      If I have missed you,  I apologize.  These people have each made  very
  198.      significant  contributions  to  the  development of GT.  The nature of
  199.      their contributions has been intangible.  Things like the feedback  of
  200.      ideas,  the  encouragement to excel,  and bug reports.  In some cases,
  201.      actual work has been contributed,  for  example  several  people  have
  202.      expended  considerable  effort  to  design new screens for GT and help
  203.      rewrite the documentation.  (Any bad things or missing things  in  the
  204.      documentation are still the author's responsibility!  I write terrible
  205.      documentation. <GRIN>)
  206.  
  207.      Here is a story for trivia buffs.  Donald Fletcher, whose name appears
  208.      at the head of the list above,  who is virtually unknown within the GT
  209.      POWER  community,  continues  to be a great supporter of GT POWER.  He
  210.      was the first registered user of GT POWER and to this day,  holds  S/N
  211.      0000001.  Hey,  Don,  if  you  are  reading  this,  thanks for all the
  212.      support over the years!
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.                                     - 4 -
  237.  
  238.  
  239.      Features:
  240.      ---------
  241.      1.   ANSI Standard terminal emulation, compatible with many super-mini
  242.           and super-micro computers.  The VT-100 terminal,  manufactured by
  243.           Digital Equipment Corporation,  is an example of an ANSI Standard
  244.           terminal.
  245.  
  246.      2.   VT-52 terminal emulation,  compatible with many telephone banking
  247.           systems.  The VT-52 terminal is manufactured by Digital Equipment
  248.           Corporation and is an older type of computer terminal.
  249.  
  250.      3.   ANSI.SYS style color graphics, without the need of ANSI.SYS!
  251.  
  252.      4.   BASIC style PLAY for single voice music.
  253.  
  254.      5.   Multiple  telephone directories,  with 999 entries each.  Records
  255.           the password for each BBS,  as well as the date and time of  last
  256.           contact.  The  total number of calls,  accumulated time,  uploads
  257.           and downloads are also recorded.  The directory  may  be  perused
  258.           while on-line with a host system.
  259.  
  260.      6.   Circular  redialing  queue.  Up  to  999  numbers may be put into
  261.           queue.
  262.  
  263.      7.   Capture Mode, limited only by the amount of disk space available.
  264.           A spill file is used,  when  the  capture  buffer  is  full.  The
  265.           capture  buffer  can be reviewed on-line,  before saving to disk.
  266.           The amount of data in the capture  buffer  is  displayed  on  the
  267.           status line.
  268.  
  269.      8.   ASCII file transmission,  using  XON/XOFF  protocol and/or line-
  270.           by-line pacing and/or inter-character delays.
  271.  
  272.      9.   Support for an ENQ answerback.  For systems requiring a  response
  273.           to the Ctrl-E character.  The same substitutions used in keyboard
  274.           macros  are available for use in the ENQ answerback,  such as '|'
  275.           for carriage return and '~' for a 1 second delay.
  276.  
  277.      10.  Full control of all communication parameters.  Plus, full support
  278.           for 16550A UART (very nice for use with high speed modems  and/or
  279.           multi-tasking setups).
  280.  
  281.      11.  40  function  keys,  to store logon,  passwords,  etc.  NEW,  the
  282.           function keys have been expanded to  keyboard  macro  status,  so
  283.           that  automation  of  the  program  can  be  easily accomplished,
  284.           includes record and playback  features.  On  enhanced  keyboards,
  285.           with 12 Fn keys, GT supports 48 function keys.
  286.  
  287.      12.  Full printer support, using XON/XOFF flow control with the host.
  288.  
  289.      13.  Xmodem/CRC  protocol.   Plus  optional  support  for  the  Xmodem
  290.           Checksum protocol.
  291.  
  292.      14.  WXmodem  protocol.  This is the full-duplex,  windowed version of
  293.  
  294.  
  295.                                     - 5 -
  296.  
  297.  
  298.           Xmodem.
  299.  
  300.      15.  Ymodem/CRC protocol.  Both the batch and single file  version  of
  301.           this  protocol  are supported.  Ymodem uses 1024 bytes per packet
  302.           vs.  128 bytes per packet in Xmodem.  During  transmission  of  a
  303.           file  with  Ymodem,  if  more than 5 errors are encountered,  the
  304.           transmission will fallback to normal length  blocks.  This  saves
  305.           time,  because  of  the high overhead encountered with Ymodem re-
  306.           transmission of error blocks.
  307.  
  308.      16.  Ymodem-G protocol.  This protocol is supported in the batch form.
  309.           It  is  a  full  streaming  protocol,   and  is  extremely  fast,
  310.           especially when used with the newer high speed modems.
  311.  
  312.      17.  Telink/CRC batch file transfer protocol.
  313.  
  314.      18.  The  exclusive GT POWER protocol,  1k Telink,  which combines the
  315.           batch capabilities of Telink with the efficiency of  Ymodem's  1k
  316.           block length.
  317.  
  318.      19.  The  exclusive  GT POWER protocol,  MegaLink,  which combines the
  319.           latest 32  bit  CRC  technology  with  a  full-flow,  PC  Pursuit
  320.           friendly,  batch  protocol.  This  protocol  is  among  the  most
  321.           efficient and reliable of protocols.  PC Pursuit is a service  of
  322.           Telenet Communications Corporation.
  323.  
  324.      20.  SEAlink   transfer  protocol  is  supported.   This  protocol  is
  325.           extremely efficient and ideal for use with such  BBS  systems  as
  326.           OPUS.
  327.  
  328.      21.  Sixteen slots for external protocols to be added by the user.  GT
  329.           comes  with several of these slots pre-setup for the most popular
  330.           protocols, i.e.  Zmodem, Kermit,  Jmodem,  Super8k,  and BiModem.
  331.           These can be easily changed or added to by modifying the External
  332.           Protocol Table in the GT configuration.
  333.  
  334.      22.  DOS Shell.  Exit to DOS then return, GT stays in the background.
  335.  
  336.      23.  An  extensive,  interactive,  script  language,  to automate many
  337.           repetitive tasks.
  338.  
  339.      24.  Optional LOG file.  Keeps a complete record of your calls.
  340.  
  341.      25.  Advanced "call progress" detection.  Detects BUSY, VOICE, NO DIAL
  342.           TONE,  and more,  with modems that support extended result codes,
  343.           such as the USRobotics Courier 2400 Modem.  Multiple result  code
  344.           entries  can  be  entered so that more than one modem type can be
  345.           easily supported.  For example,  the result codes for Racal-Vadic
  346.           and  Hayes  modems  could  be simultaneously recognized.  This is
  347.           very handy for users of PC Pursuit,  allowing  them  to  use  the
  348.           native mode of the Racal-Vadic modems in use by that service.
  349.  
  350.      26.  Smart  modem  result  code  handling.  Automatically  detects the
  351.           usage of MNP, baud rate and connection,  EVEN if the modem result
  352.  
  353.  
  354.                                     - 6 -
  355.  
  356.  
  357.           code  table  is  incomplete  or inaccurate.  This eases the setup
  358.           procedure for many modems!  Verbose modem result  codes  must  be
  359.           used to take advantage of this feature.
  360.  
  361.      27.  Use of the environment variable,  GTPATH,  to simplify use of the
  362.           program on a hard disk.
  363.  
  364.      28.  On-screen clock,  so there is no need for a memory resident clock
  365.           program.
  366.  
  367.      29.  Host  mode.  Allows the user to setup a system to accept incoming
  368.           calls.  File transfers can be made without  the  use  of  a  BBS!
  369.           Complete  security  is incorporated into the host.  The host mode
  370.           also includes a powerful message  system.  A  flexible  ring-back
  371.           procedure if provided to enable sharing of a data line with voice
  372.           requirements.
  373.  
  374.      30.  Support for the non-standard COM ports: 3 and 4.
  375.  
  376.      31.  Support for non-standard IRQ assignments for the COM port.
  377.  
  378.      32.  For those with limited disk space,  a Terminal Only version of GT
  379.           is  distributed.   This  version  is  referred  to  as  GTO,  for
  380.           GTerminal Only.  It saves  more  than  90k  of  disk  space  when
  381.           compared with the full GT version.
  382.  
  383.      33.  With non-batch protocols,  such as Xmodem, WXmodem and Ymodem, GT
  384.           will scan the screen for the filename indicated to the BBS.  This
  385.           can save double typing of the filename.  A  very  handy  feature.
  386.           To make complete use of this feature,  you should set the default
  387.           protocol for each BBS to be one of the protocols listed above.
  388.  
  389.      34.  Support for Zmodem auto-download.  This  means  that  during  the
  390.           terminal  mode  of  GT,  the  program  will  trap  out the Zmodem
  391.           signature coming from the host and automatically  drop  into  the
  392.           ZMRX.BAT file whenever detected.
  393.  
  394.      35.  Support for 43 line mode on EGA systems and 50 line mode on
  395.           VGA systems.
  396.  
  397.      36.  Support  for  DESQview  -  an  excellent  multitasking  operating
  398.           environment  by  Quarterdeck  Office  Systems.  GT  will  give-up
  399.           unused  time  to DESQview and will write directly to the DESQview
  400.           video buffer - for fast screen updates!
  401.  
  402.      37.  GT NetMail.  This is a very inexpensive way to  communicate  with
  403.           your  fellow  GT  users.  Most GT host systems participate in the
  404.           network, which stretches from Australia thru the US and Canada to
  405.           the United Kingdom and the  Netherlands.  NOTE:  The  GT  NetMail
  406.           programs  are  not shareware.  They are provided at no extra cost
  407.           to users who register GT.  An extra incentive to register GT!
  408.  
  409.      38.  GT  is  a  shareware  product.  This means that it is provided at
  410.           little or no cost to the end user for an evaluation.  If the user
  411.  
  412.  
  413.                                     - 7 -
  414.  
  415.  
  416.           decides to continue using GT past a reasonable evaluation period,
  417.           then the user is expected to submit the  requested  donation.  In
  418.           this spirit, GT has incorporated within it a "usage counter", for
  419.           each  usage  the  program  will  delay  startup for an additional
  420.           1/30th of a second.  This  delay  has  a  maximum  value  of  120
  421.           seconds.  If the user decides to register GT,  then the user will
  422.           receive a key,  which bypasses the delay and allows the  user  to
  423.           enter the program much more quickly.
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.                                     - 8 -
  473.  
  474.  
  475.      Functional Overview
  476.      -------------------
  477.      GT POWER is  a  set  of  programs  and  files  that  provide  complete
  478.      capabilities for your system.  It has been designed to be based on IBM
  479.      and  compatible  micro-computers  and  it  supports  a wide variety of
  480.      modems including all Hayes compatibles, USRobotics, and IBM.
  481.  
  482.      As  you  have  seen from the previous three pages which listed many of
  483.      the features of this program,  there are a large number of  functional
  484.      capabilities provided by GT POWER.  Nevertheless, you will quickly see
  485.      that  these  functions  have  been  provided  in  a very user friendly
  486.      environment,  and that the software is quite easy to use.  It  is  not
  487.      necessary,  for example,  to remember any commands or special features
  488.      of the program as there is a comprehensive Help Menu available to  you
  489.      at any time the program is running.
  490.  
  491.      Basically there are three usages of a communications system such as GT
  492.      POWER:
  493.  
  494.      1.   To  call  other  computer  systems  and  engage  in  'telex-like'
  495.           conversations with the person (or computer) called.
  496.  
  497.      2.   To transfer files (programs and data) between computers.
  498.  
  499.      3.   To establish an  unattended  host  mode  environment  that  other
  500.           computer users can call and interact with.  For example,  to send
  501.           files to your system or  to  leave  messages  for  later  review,
  502.           sometimes called 'Electronic Mail'.
  503.  
  504.      GT  POWER  provides  these  three  broad categories of functions and a
  505.      great deal more.  A few examples include:
  506.  
  507.           The  ability  to  use any of the DOS Commands without exiting the
  508.           program.
  509.  
  510.           Capturing to disk all the text that is  exchanged  while  in  the
  511.           'telex-like' terminal mode.
  512.  
  513.           Automatically dialing the telephone for you.
  514.  
  515.           Maintaining a complete log of all telephone activity.
  516.  
  517.           Providing  a  secure  environment  that protects your system from
  518.           unwanted invasion by outside callers.
  519.  
  520.      Before you can use GT POWER you will need to install the  software  on
  521.      your  system.  The installation process is relatively easy to perform,
  522.      but it does require that you know a few things about  your  system  in
  523.      advance.  For example,  you will need to know which port your modem is
  524.      connected to (usually #1 if you have a parallel printer or #2  if  you
  525.      are using a serial printer).
  526.  
  527.      You  will  need  to  know a few technical things about your modem,  as
  528.      well.  If you are using a Hayes or Hayes compatible modem (1200  baud)
  529.  
  530.  
  531.                                     - 9 -
  532.  
  533.  
  534.      the system is already setup for your use.  If not,  then you will need
  535.      to have a copy of the technical reference  manual  that  was  supplied
  536.      with your modem.
  537.  
  538.      After you have started GT POWER, a SHAREWARE notice will appear, and a
  539.      delay will commence (1/30th of a second for each usage of the program,
  540.      with a maximum delay of 120 seconds).  After the  delay  has  expired,
  541.      the  program will invite you to 'Press any key to continue'.  Pressing
  542.      a key results in the display of the  'Copyright'  screen,  which  will
  543.      explain  the  details of the GT POWER shareware plan,  and you will be
  544.      invited to press 'Y' to continue.  Pressing 'Y' results  in  GT  going
  545.      directly  into  it's Dialing Directory display (the method of entering
  546.      the program is extremely simplified for registered users,  who will be
  547.      able  to enter the program automatically without any keystroke,  after
  548.      viewing the 'Copyright' notice  for  a  couple  of  seconds).  In  the
  549.      Dialing  Directory  you will see a list of names and telephone numbers
  550.      that you have told GT about during previous usage and a short menu  is
  551.      shown  at  the  bottom  of  the  screen.  If  you wish to call another
  552.      computer at this time you need only move the cursor to the appropriate
  553.      line and press the Enter key.  GT will  then  automatically  dial  the
  554.      requested telephone number and monitor the progress of the call.  That
  555.      is,  it  will  show you that the call is being placed and it will tell
  556.      you what is happening on the telephone line thereafter.  For  example,
  557.      if  the  telephone on the other end is busy it will show BUSY (if your
  558.      modem has extended result codes).  When it gets through to  the  other
  559.      computer, GT will show you that it has CONNECTED with that system.
  560.  
  561.      There  are  many  ways  in  which  files  can  be  transmitted between
  562.      computers.   Text  files  are  often  sent   without   any   elaborate
  563.      conventions  that  insure  the  integrity of those transmissions,  but
  564.      program files are always sent utilizing what  is  called  a  Protocol.
  565.      Transmissions that utilize a protocol insure that the file received is
  566.      exactly like the one sent.
  567.  
  568.      GT POWER provides nine built-in and  sixteen  external  file  transfer
  569.      protocols  for  your  use.   Each  one  has  its  own  advantages  and
  570.      disadvantages over the others.  More important than their  differences
  571.      is  that  many  of  the  computers  that  you will be calling can only
  572.      support a few different protocols and the variety provided by GT POWER
  573.      insures that you can use the ones provided on the other computer.
  574.  
  575.      Subsequent sections of this document will show  you  the  many  varied
  576.      functions  and  features available with GT POWER in great detail.  The
  577.      host mode capabilities are so extensive, however, that we have elected
  578.      to provide a separate document to describe them in detail.
  579.  
  580.      Note:  GT  POWER  is a Shareware product that may be obtained directly
  581.             from the author,  from any existing user  of  the  product,  or
  582.             through  file  transfer  of the program from any of hundreds of
  583.             bulletin board systems near you.  In almost all cases you  will
  584.             receive  the product as a set of five files (GT1600_1.LZH,  _2,
  585.             _3,  _4,  and _5).  These files will be in what is known as  an
  586.             archive  format.  In  order  to  extract the actual program and
  587.             data files from the archive file  you  have  you  must  use  an
  588.  
  589.  
  590.                                    - 10 -
  591.  
  592.  
  593.             archive  extraction  program  such  as  LHARC  which is readily
  594.             available on most bulletin boards.
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.                                    - 11 -
  650.  
  651.  
  652.      Installation Notes
  653.      ------------------
  654.      Versions 4.20, 8.00, 9.00, 9.10, 9.20, 11.00,  14.00,  15.00 and 15.50
  655.      of  GT  introduced  new formats for the phone directory.  One may ask,
  656.      "Why so many changes?".  The answer is simple, we at P&M Software (P&M
  657.      stands for Paul and Mari) believe in providing functions requested  by
  658.      our users,  whenever possible.  Because of all the improvements in the
  659.      phone directory,  users of older versions of GT must run  the  program
  660.      GT_UTIL  to  convert their old directories to the new format.  I think
  661.      you will like the newer format, it includes the date and time that you
  662.      last called each number in the directory,  the total number  of  times
  663.      you  called  each  number,  the  total  duration of your calls to each
  664.      number,  a record of upload  and  download  amounts  to  each  number,
  665.      default  file  transfer  protocol,  logon  script,  and room for ample
  666.      comments.  When run,  GT_UTIL will rename your original  directory  to
  667.      _GT.DIR, so that you will retain a copy of it for emergency use.
  668.  
  669.      The program comes packaged  as  an  .EXE.  The  program  disk  may  be
  670.      removed after the program has begun (if using the standard un-overlaid
  671.      version).  There  are  two  methods  available  to  have GT locate the
  672.      required configuration and control files.
  673.  
  674.      The 1st,  and possibly the simplest,  is to start GT in the  directory
  675.      that contains all of these files.  The program will detect the default
  676.      directory  and will refer back to it when needed,  even after the user
  677.      has changed directories.
  678.  
  679.      The 2nd method is to use an Environment variable, GTPATH,  to point to
  680.      the directory containing GT's files.  This method is more difficult to
  681.      setup,  but  is  much  more  flexible  once  the  program  is properly
  682.      installed.
  683.  
  684.      NOTE:  If GTPATH is set,  GT will *not* look in the default  directory
  685.             for any of the needed files, instead will look in the directory
  686.             indicated by GTPATH.
  687.  
  688.      The phone directory may be placed on any drive and directory, the path
  689.      to the phone directory is set into the configuration file via the Alt-
  690.      I  command.  There  are  also  separate PATH's for upload and download
  691.      directories  and  other  areas.  The  phone  directory  path  MUST  be
  692.      correctly set, otherwise the program will not be able to use the phone
  693.      directory,  but the upload and download PATH's are optional.  A script
  694.      path is also configurable, so that a separate directory may be used to
  695.      store scripts.  A capture path can be configured, so that GT will know
  696.      where to save your capture sessions (it is usually NOT a good idea  to
  697.      save  your captures in the current directory -- you would quickly lose
  698.      track of them!).  Other pathnames  may  also  be  configured  in  GT's
  699.      setup,  refer  to item #13 under the "Miscellaneous Options" selection
  700.      of the Alt-I screen.
  701.  
  702.  
  703.      External Protocols
  704.      ------------------
  705.      As shipped, GT comes pre-configured for 4 external protocols,  with 16
  706.  
  707.  
  708.                                    - 12 -
  709.  
  710.  
  711.      possible external protocols.  To alter these definitions or to add new
  712.      protocols, you must bring up the Alt-I configuration screen and select
  713.      #6,  the setup for external protocols.  You will be presented with the
  714.      following table:
  715.  
  716.                    Protocol     BAT     Menu   Batch   Two    Over
  717.             No      Name        File    Char   XFER?   Way?   Lay(1)
  718.             ══   ════════════   ═════   ════   ═════   ════   ════
  719.              1   Jmodem          JM       J      N       N      N
  720.              2   Kermit          KR       K      Y       N      N
  721.              3   Zmodem          ZM       Z      Y       N      N
  722.              4   BiModem         BI       I      Y       Y      Y
  723.              5   ____________    __       _      _       _      _
  724.              6   ____________    __       _      _       _      _
  725.              7   ____________    __       _      _       _      _
  726.              8   ____________    __       _      _       _      _
  727.              9   ____________    __       _      _       _      _
  728.             10   ____________    __       _      _       _      _
  729.             11   ____________    __       _      _       _      _
  730.             12   ____________    __       _      _       _      _
  731.             13   ____________    __       _      _       _      _
  732.             14   ____________    __       _      _       _      _
  733.             15   ____________    __       _      _       _      _
  734.             16   ____________    __       _      _       _      _
  735.  
  736.             (1) Requires the /V:E command line option to activate.
  737.  
  738.      The "BAT File" column contains the first two characters that are  used
  739.      to  compose  the  name  of  the  batch  file  required  to execute the
  740.      protocol.  Batch files are provided for the pre-configured  protocols,
  741.      as follows:
  742.  
  743.                          JMRX.BAT ...... Jmodem Receive
  744.                          JMTX.BAT ...... Jmodem Transmit
  745.                          KRRX.BAT ...... Kermit Receive
  746.                          KRTX.BAT ...... Kermit Transmit
  747.                          ZMRX.BAT ...... Zmodem Receive
  748.                          ZMTX.BAT ...... Zmodem Transmit
  749.                          BIRX.BAT ...... BiModem Receive
  750.                          BITX.BAT ...... BiModem Transmit
  751.  
  752.      Note that the first two characters of each name indicate the protocol
  753.      in  use  and  the  next  two characters indicate either receive(RX) or
  754.      transmit(TX).  Since BiModem is a  "TWO  WAY"  protocol,  sending  and
  755.      receiving  at  the  same  time,  the  BiModem  batch  files  should be
  756.      identical for both receive and transmit.
  757.  
  758.      The internal structure of each batch file is dependent on the  details
  759.      of  the  individual protocol driver in use.  Each driver varies in the
  760.      needs  it  has.  The  interface  from  GT  to  these  batch  files  is
  761.      consistent,  so that you can quickly learn to create new files for new
  762.      protocols.  Up to 9 parameters can be passed to a protocol batch file,
  763.      the  1st is the COM port number in use and the 2nd is the current baud
  764.      rate used on the  COM  port.  Parameters  3  through  9  are  filename
  765.  
  766.  
  767.                                    - 13 -
  768.  
  769.  
  770.      specifications.  With batch protocols, the filename specifications may
  771.      contain  the  wild  card  characters  '?'  or '*'.  Please examine the
  772.      included batch files for examples of proper construction.
  773.  
  774.      External protocol drivers may overlay GT if  they  require  additional
  775.      memory  to  accomplish their chores.  However,  the overlay feature is
  776.      disabled,  unless you use the /V:E command line  option.  This  method
  777.      gives  you  the flexibility to decide which protocols you will overlay
  778.      and have a master switch on the command line to override.
  779.  
  780.      Through the use of a temporary directory, GT$WORK$,  GT is able to log
  781.      the  actual  files that are received by an external protocol.  GT will
  782.      create  this  directory  automatically  under  the   user's   download
  783.      directory  and  will move the files received into that directory after
  784.      logging has been completed.  If duplicate  files  are  received,  they
  785.      will  be  moved  to  a  DUPS directory created automatically under the
  786.      user's  download  directory.  Under  normal  operation,  the  GT$WORK$
  787.      directory  will  be  removed  automatically  after  it  has served its
  788.      purpose.  If it should remain on your disk,  then some sort of problem
  789.      has been encountered, that GT is unable to handle.
  790.  
  791.      In addition to using the command line arguments to pass  filenames  to
  792.      external  protocol batch files,  when uploading or transmitting a file
  793.      or batch of files,  GT also creates a list file - called GT_XMIT.LST -
  794.      in the GTPATH directory (or the directory where you started GT,  if no
  795.      GTPATH environment variable has been setup).  This list file  is  very
  796.      handy  for use with protocol drivers that support the feature,  due to
  797.      the limited size of the command line under DOS -- it is limited to 128
  798.      characters!  Here is an example of a  batch  file  for  Zmodem  upload
  799.      using the list file feature:
  800.  
  801.               dsz port %1 speed %2 both sz @C:/gt/gt_xmit.lst
  802.  
  803.      Where  'C:\GT' is the GTPATH directory.  Also notice the use of '/' in
  804.      the pathname after the '@C:',  the DSZ program supports the use of '/'
  805.      as  the  delimiter  within  pathnames due to its UNIX heritage.  Other
  806.      programs may not support the '/'  character  in  pathnames,  in  which
  807.      case, the normal DOS '\' should be used.
  808.  
  809.  
  810.      IMPORTANT:
  811.      ==========
  812.      There  are  two  methods  available to have GT hang-up the phone line.
  813.      First,  the default method, the "Hang-up String" is sent to the modem.
  814.      The "Hang-up String"  must  contain  an  escape  character  -  usually
  815.      "~+++~"  for  Hayes type modems,  so make sure that the S2 register of
  816.      your modem is set properly.  GT can also control the modem via the DTR
  817.      signal.  If the DTR switch is set to  the  "normal"  position  on  the
  818.      modem,  GT  can  hang-up  the  phone  line by dropping the DTR signal.
  819.      NOTE:  the "normal" position for the DTR switch is *not*  the  factory
  820.      setting,  which  is  usually  to  force  DTR  at  all  times (which is
  821.      completely useless with GT).  If you choose the DTR method,  you  MUST
  822.      DELETE  ALL  the  characters  from  the  "Hang-up  String"  in  the GT
  823.      configuration.
  824.  
  825.  
  826.                                    - 14 -
  827.  
  828.  
  829.  
  830.      It is  very  important  that  the  modem  result  codes  are  properly
  831.      installed.  If  the program cannot connect properly then the codes are
  832.      not correct.  There are several things which must agree to  enable  GT
  833.      to  recognize  the  modem's result codes:  (1) the desired Vn command
  834.      must be added to the modem init strings,  (2) the desired Xn  command
  835.      must  be  added  to  the  modem  init  strings,  (3) the result codes
  836.      corresponding to the selected Vn command  must  be  installed  in  the
  837.      result  code table.  The Vn command controls whether the modem returns
  838.      verbose, V1, or numeric, V0, result codes.  The  Xn  command  controls
  839.      the result code set reported to GT from the modem,  X0 tells the modem
  840.      to use the basic result code set (not extremely useful),  X1 is better
  841.      and  is  the  first  of  the "extended" result code sets,  however you
  842.      should use one of the result code sets that include  the  BUSY  result
  843.      code -- which greatly speeds the list dialing routines.
  844.  
  845.      It is recommeded that the verbose result codes are  used  with  modems
  846.      that have many  different  variations  of  the  CONNECT  result  code.
  847.      Because  there  simply is not enough room in GT's result code table to
  848.      hold all of them!  And,  if verbose result codes are returned  by  the
  849.      modem,  GT  will  be  able  to use its advanced algorithm for handling
  850.      these codes automatically.  GT is able to detect the  usage  of  error
  851.      correction, in many different flavors (i.e.  MNP, ARQ, V.42, etc), the
  852.      DTE  baud  rate,  and  the  presence  of a successful connection - all
  853.      automatically - when verbose result codes are  enabled.  There  is  an
  854.      assumption  here,  and  that  is  that  the modem adheres to the Hayes
  855.      standard format style for verbose codes.  That  is  that  the  verbose
  856.      connect codes should start with the word CONNECT,  followed by the DTE
  857.      baud rate, and then the error correction type.
  858.  
  859.  
  860.      Example of Environment Usage
  861.      ----------------------------
  862.      Assuming  that  all the GT files have been placed in a directory named
  863.      \GT on drive C.  Then in your AUTOEXEC.BAT file place the following:
  864.  
  865.                                 PATH=C:\GT;C:\
  866.                                 set GTPATH=C:\GT
  867.  
  868.      Of course, DOS's PATH variable may have additional directories listed,
  869.      using the semi-colon to separate the names.  The GTPATH variable  must
  870.      have  only  1 parameter,  the home directory for most of the GT files.
  871.      NOTE: it is wise to include the root directory in DOS's PATH variable,
  872.      as this enables COMMAND.COM to be executed as  any  other  program  --
  873.      this is necessary to run the DOS Shell mechanism.
  874.  
  875.  
  876.      Notes on DOS 3.2 and 3.3
  877.      ------------------------
  878.      It is necessary to place certain entries into the CONFIG.SYS file when
  879.      using  DOS  3.2 for the proper operation of GT POWER.  The entries are
  880.      as follows:
  881.  
  882.                                   STACKS=30,256
  883.  
  884.  
  885.                                    - 15 -
  886.  
  887.  
  888.                                   BUFFERS=40
  889.                                   FILES=60
  890.  
  891.      The BUFFERS value can be less if you are using a hard disk with  small
  892.      directories,  i.e.  less  than  100  files  per  directory.  The FILES
  893.      parameter can also be less, but DOS doesn't use the extra FILES unless
  894.      needed, so it is not critical.
  895.  
  896.      The STACKS value is very important,  especially for  users  that  make
  897.      great usage of scripts.  Random failure of the system is possible,  if
  898.      the STACKS command does not have large enough values in it.
  899.  
  900.      Under  DOS  3.3,  the  same recommedations are valid,  except that the
  901.      STACKS value should be increased, as follows:
  902.  
  903.                                   STACKS=30,512
  904.  
  905.      General Notes On DOS
  906.      --------------------
  907.      It is very easy to  use  all  available  file  handles  within  a  DOS
  908.      environment.  Especially if you are using external processes like DSZ,
  909.      PCKERMIT,  the  DOS  Shell,  or  multi-tasking  software.  So,  it  is
  910.      extremely important that adequate FILES are reserved in the CONFIG.SYS
  911.      file on your DOS boot disk.  It is recommended that no fewer  than  60
  912.      be reserved, as shown above in the notes on DOS 3.2 and 3.3.
  913.  
  914.      When  using DOS 3.1,  it has been found that a large number of BUFFERS
  915.      is also beneficial.  On the GT support BBS,  BUFFERS=95  is  routinely
  916.      used with DOS 3.1.
  917.  
  918.      IMPORTANT:  The large number of buffers useful with DOS 3.1 can  cause
  919.                  severe  problems  with DOS 3.2.  For example,  never use a
  920.                  value for BUFFERS  greater  than  40  with  DOS  3.2.  The
  921.                  variation  between  such closely related operating systems
  922.                  is surprising to this observer.
  923.  
  924.  
  925.      Modem Result Codes
  926.      ------------------
  927.      The proper setting of the modem result codes is terribly important, if
  928.      the automatic dialing routines are to work properly.  Again,  one must
  929.      use the Alt-I command, then select the modem result codes option.  The
  930.      program  will present a list of possible results and the corresponding
  931.      codes that the modem uses to signal each result.  You may  change  any
  932.      or all of the result codes, each code may be any string of characters,
  933.      up  to  50  characters long.  The default codes are set to the verbose
  934.      codes supported by the USRobotics Courier HST 9600 baud modem, if your
  935.      modem does not signal all of the possible results,  DO NOT DELETE  the
  936.      code.  Especially  if  you use PC Pursuit,  the modems used by Telenet
  937.      send the BUSY code instead of the NO CARRIER code, so you should leave
  938.      these codes in the table, even if your modem doesn't support them.
  939.  
  940.      Don't neglect the Modem Init String!  This string  can  have  a  great
  941.      impact on your modems result codes.  Especially important,  one should
  942.  
  943.  
  944.                                    - 16 -
  945.  
  946.  
  947.      include the highest possible Xn command  in  Modem  Init  String.  For
  948.      example, I use X5 with my USRobotics Courier.  For the Hayes 1200 baud
  949.      modems,  I  suggest  a value of X1 and for the 2400 baud Hayes I would
  950.      use X4.  Naturally, the Vn command is equally important.  For example,
  951.      if you use V1 in the init string,  then you MUST have verbose codes in
  952.      the modem result code table.
  953.  
  954.  
  955.      Multiple Result Codes
  956.      ---------------------
  957.      GT POWER supports multiple result codes to mean  that  mean  the  same
  958.      thing.  This is extremely handy if you have a modem that sends several
  959.      different codes to indicate one of the results in the table, or if you
  960.      have  an  application  which requires use of different modems with the
  961.      same setup (for example, PC Pursuit uses Racal-Vadic modems,  but most
  962.      users  have  Hayes  compatible  modems).  To  indicate multiple result
  963.      codes,  you simply enter the various codes with a comma  between  each
  964.      code.  Do not enter any extra blanks or other non-essential characters
  965.      in the result code table.  For example:
  966.  
  967.                            0,OK,GOOD,READY
  968.                            1,CONNECT,CONNECT 300
  969.  
  970.      Notice  the  first  line  above  defines  4  separate codes which will
  971.      correspond to the "OK" response.  The second line defines 3 codes that
  972.      will correspond to the "CONNECT" response.
  973.  
  974.      Please note,  when using this feature to access non-Hayes type modems,
  975.      one  must  remember  to  switch the Dialing Pre-string to the required
  976.      value for each modem -- this can easily  be  done  with  one  of  GT's
  977.      keyboard macros.
  978.  
  979.  
  980.      First Time Usage
  981.      ----------------
  982.      Many of the features of the program are self-documenting,  however for
  983.      the sake of the novice user, some explanation is necessary.
  984.  
  985.      The  GT  program  is  distributed  in  .EXE,  which  can  be  executed
  986.      immediately by placing your disk into drive A,  changing  the  default
  987.      drive  to  A:,  if  not already,  then typing the name of the program,
  988.      GT1600.  Normally,  however,  the program will be run from a Hard disk
  989.      after  it  has been copied into its own directory and the DOS PATH has
  990.      been established,  as well as definition of the GTPATH variable in the
  991.      DOS environment per the previous section of this manual.
  992.  
  993.      If you are running  from  a  hard  disk  system  setup  as  previously
  994.      described  then  it would be convenient for you to create a batch file
  995.      that will invoke GT POWER for you.  For example,  you might  create  a
  996.      batch file called GT.BAT which contains only a single line as follows:
  997.  
  998.                                      GT1600
  999.  
  1000.      Placing  that  batch  file  anywhere  in  the PATH that DOS has at its
  1001.  
  1002.  
  1003.                                    - 17 -
  1004.  
  1005.  
  1006.      disposal will allow you to start GT POWER from any directory by merely
  1007.      typing GT.
  1008.  
  1009.      Once the user has successfully  entered  the  program,  the  copyright
  1010.      notice will appear.  Press the 'Y' (if you are a registered user,  the
  1011.      program will auto-start), the phone directory screen will then appear.
  1012.      The phone directory is used to store the phone numbers of the  various
  1013.      systems you call.  You must enter these numbers before GT can automate
  1014.      your  dialing  chores.  Use the A)dd command in the phone directory to
  1015.      add numbers,  by pressing the <A> key.  The <Esc> key may be  used  to
  1016.      exit from the phone directory to the on-line screen.  At the bottom of
  1017.      the  on-line screen appears various status indicators and the reminder
  1018.      that Alt-H is the help key.  A complete list of available commands can
  1019.      be obtained by selecting Alt-H.  Commands may be  selected  while  the
  1020.      Help window is still on screen, so that the user does not need to open
  1021.      the  Help  window repetitively,  however some commands are not readily
  1022.      executable while any "window" is open - the time management  commands,
  1023.      Alt-U and Alt-F,  are an example.  If they are executed while the Help
  1024.      window is open,  they will cause the screen to  scroll!  This  is  not
  1025.      harmful in any way, but renders the Help window less useful.
  1026.  
  1027.      The  25th  line  on your monitor provides important status information
  1028.      about your  system  while  running  GT  POWER.  Please  refer  to  the
  1029.      Appendix  at  the  end  of this document for a complete listing of the
  1030.      contents of the 25th line.
  1031.  
  1032.      Upon initial execution the program creates several files in  its  home
  1033.      directory.  They are:
  1034.  
  1035.                            Modify
  1036.               Filename     Command       Description
  1037.               --------     -------       -----------
  1038.                GT.KEY ..... Alt-M ...... Stores the macro key definitions.
  1039.                GT.DIR ..... Alt-D ...... Stores the phone directory.
  1040.                GT.CNF ..... Alt-I ...... Stores the program configuration.
  1041.  
  1042.      The  keystrokes  shown  above  under  "Modify  Command"  are  the ones
  1043.      required to bring up screens which will allow  you  to  customize  the
  1044.      program for your specific use.
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.                                    - 18 -
  1063.  
  1064.  
  1065.      Command Line Usage
  1066.      ------------------
  1067.      When  you  start GT,  there are several command line switches that are
  1068.      available to you:
  1069.  
  1070.  
  1071.      name      You may indicate a script file to be executed upon  start-up
  1072.                of GT.
  1073.  
  1074.      /D        You may indicate whether or not you wish to have GT drop the
  1075.                DTR signal to the modem when GT exits back to DOS.
  1076.  
  1077.      /C        You  may indicate whether you are connected via cable to the
  1078.                host computer.
  1079.  
  1080.      /K        You may initiate the capture mode from the very start of the
  1081.                program.
  1082.  
  1083.      /L        You may control the duration and tone of beeps produced by
  1084.                the program.  For example:
  1085.  
  1086.                                    /Lm:n
  1087.  
  1088.                Where 'm' is  a  number  from  0  to  9,  which  varies  the
  1089.                frequency  of  the beep.  0 is the lowest and 9 the highest.
  1090.                And 'n' is the duration of the  beep  is  milleseconds.  The
  1091.                'n' is in milliseconds and defaults to 225 milliseconds.
  1092.  
  1093.      /P        You may enable logging to the system printer.
  1094.  
  1095.      /1        You may configure the port addresses in use by  your  serial
  1096.                port.  The  actual  port  number to be configured,  1-4,  is
  1097.                placed  after  the  slash.  The  new  base  address  of  the
  1098.                indicated  port  is  placed  after  the slash number with an
  1099.                intervening blank.  The address must be given with a leading
  1100.                $ sign and be in hex notation,  for example $3F1 would be  a
  1101.                valid address.  Refer to your hardware documentation for the
  1102.                correct  address  to use.  GT uses standard addresses if you
  1103.                do  not  override  with  this  option.  To  change  the  IRQ
  1104.                assignment,  the port address can be followed with a ':' and
  1105.                a new IRQ value.  The permissible range of IRQ values  is  0
  1106.                to  7.  And,  please  make sure you don't use an IRQ already
  1107.                used by something else!
  1108.  
  1109.  
  1110.      /Rn       This  option  applies to the GT host mode.  It specifies the
  1111.                ring number upon which GT will answer  incoming  calls.  For
  1112.                example /R3 would cause GT to answer on the 3rd ring.  NOTE:
  1113.                that  the  host  mode modem init string must contain S0=0 to
  1114.                allow this to work properly.
  1115.  
  1116.      /RBmm:nn  This option applies to the GT host mode.  It specifies  that
  1117.                GT  should  answer the modem after a "ring back".  To enable
  1118.                this option to work  properly,  the  host  mode  modem  init
  1119.  
  1120.  
  1121.                                    - 19 -
  1122.  
  1123.  
  1124.                string  must  contain  S0=0.  Once  installed  properly this
  1125.                option makes the GT host mode answer the phone on the 2nd or
  1126.                3rd ring after a gap of between 'mm' and  'nn'  seconds.  If
  1127.                the  gap  between rings is less than 'mm' seconds or greater
  1128.                than 'nn' seconds,  GT  will  not  answer  the  phone.  This
  1129.                allows  the  use  of  an answering machine on the same phone
  1130.                line as  the  computer.  The  answering  machine  should  be
  1131.                programmed  to  answer  on a later ring,  the 4th or 5th for
  1132.                example.
  1133.  
  1134.                /rb09:30  This  would  cause  the  gap to be 9 - 32 seconds.
  1135.                          The normal ring interval is 5  -  6  seconds.  The
  1136.                          high  end of this range should *not* be set higher
  1137.                          than 45 seconds.
  1138.  
  1139.      /S        This option modifies the 'quiet' mode.  When present, the /S
  1140.                allows the sysop page to be  heard,  effectively  overriding
  1141.                quiet mode for that single function.
  1142.  
  1143.      /Tn       This  option  specifies a new keyboard timeout value for use
  1144.                in host mode.  The default value  is  10  minutes.  The  'n'
  1145.                specifies the new value in minutes.  For example:
  1146.  
  1147.                                       /T15
  1148.  
  1149.                Would change the keyboard timeout to 15 minutes.
  1150.  
  1151.      /V:s      This option allows selected functions to  overlay  GT  while
  1152.                they  are being executed.  This frees a great deal of memory
  1153.                for these functions to use.  The 's' represents the list  of
  1154.                functions that will overlay GT.  For example:
  1155.  
  1156.                                       /V:ED
  1157.  
  1158.                The  letters following the ':' need not be in any particular
  1159.                order and only the desired functions need be specified.  The
  1160.                following functions are may be specified:
  1161.  
  1162.                           E = External Protocols
  1163.                           D = DOOR batch files
  1164.                           L = Logon/Logoff batch files
  1165.  
  1166.                The default is to run these items in a  normal  shell  (non-
  1167.                overlay), if you specify any of these characters with the /V
  1168.                option,  then the corresponding function will be executed in
  1169.                an overlay fashion.  Crash mail,  the GTI interface and  the
  1170.                Remote Sysop Shell are automatically overlaid.
  1171.  
  1172.                An  external protocol may be selectively run via the overlay
  1173.                method  by  setting  the  overlay  switch  in  the  External
  1174.                protocol  table  on  the  Alt-I  configuration screen.  In a
  1175.                similar  manner,   individual  DOOR  batch  files   may   be
  1176.                selectively  run  via the overlay method by setting a switch
  1177.                in the GTDDIR.BBS file (see GT16HOST.DOC file for details).
  1178.  
  1179.  
  1180.                                    - 20 -
  1181.  
  1182.  
  1183.  
  1184.                When overlaying functions in host  mode,  the  program  will
  1185.                recycle  after a caller has logged off.  GT will exit with a
  1186.                errorlevel of 255 and your HOST.BAT file should be  made  to
  1187.                trap  this  errorlevel  and  process  it appropriately.  For
  1188.                example:
  1189.  
  1190.                              HOST.BAT
  1191.                              --------
  1192.                                 .
  1193.                                 .
  1194.                              cd \gt
  1195.                              gt1600 ... host.scr
  1196.                              if errorlevel 255 host
  1197.                                 .
  1198.                                 .
  1199.  
  1200.  
  1201.      The options listed above may be placed on  the  command  line  in  any
  1202.      order, here are some examples:
  1203.  
  1204.           gt1600                        This command would start GT without
  1205.                                         any  script,  GT  would drop DTR on
  1206.                                         exit.
  1207.  
  1208.           gt1600 /D                     Again no script,  but this time  GT
  1209.                                         would  maintain  the  DTR signal to
  1210.                                         the modem after exit to DOS.
  1211.  
  1212.           gt1600 script.scr /d          Now GT would start the script  file
  1213.                                         named   automatically   and   would
  1214.                                         maintain the DTR signal on exit  to
  1215.                                         DOS.
  1216.  
  1217.           gt1600 script.scr             GT  will  now  drop  DTR on exit to
  1218.                                         DOS,   automatically  execute   the
  1219.                                         named script upon startup.
  1220.  
  1221.           gt1600 /C                     GT  will  know that it is connected
  1222.                                         via cable to the host and will  not
  1223.                                         automatically   enter   the   Phone
  1224.                                         Directory.
  1225.  
  1226.           gt1600 /c /D                  Shows the combination of the /C and
  1227.                                         the /D switches.  Indicates that GT
  1228.                                         is connected via cable to the  host
  1229.                                         and that GT should maintain the DTR
  1230.                                         signal after exiting to DOS.
  1231.  
  1232.           gt1600 /k /2 $3E8             This  line  would start the capture
  1233.                                         mode and reconfigure COM port #2 to
  1234.                                         the  base  address  3E8  hex.   The
  1235.                                         address must be given in hex with a
  1236.                                         leading $ sign character.  It is
  1237.  
  1238.  
  1239.                                    - 21 -
  1240.  
  1241.  
  1242.                                         possible to configure the IRQ too.
  1243.                                         See the next example.
  1244.  
  1245.           gt1600 /3 $248:5              In  this  example,  COM3  is  being
  1246.                                         reassigned  to port address 248 hex
  1247.                                         and the IRQ used will be #5.
  1248.  
  1249.           gt1600 /p                     This would start GT and turn on the
  1250.                                         system  printer  to record the log.
  1251.                                         The log will also be written to the
  1252.                                         disk file  GT.LOG.  This  is  handy
  1253.                                         for host mode operators,  who would
  1254.                                         like to be able  to  read  the  log
  1255.                                         without taking their system out-of-
  1256.                                         service.
  1257.  
  1258.           gt1600 /rb host.scr           This  would start GT,  enable ring-
  1259.                                         back   mode   and    execute    the
  1260.                                         'host.scr'  script file.  (Probably
  1261.                                         to start a GT Host session.)
  1262.  
  1263.      The /D option allows the user to maintain the DTR signal to the  modem
  1264.      after  exiting  from  GT  POWER and one might ask,  "Why should DTR be
  1265.      maintained after exit to DOS?".  If DTR is maintained, you may exit to
  1266.      DOS without having to hang-up the modem,  therefore it is possible  to
  1267.      run  another  comm  program,  while  still connected to the host.  For
  1268.      example,  if you wanted to  run  the  PCKERMIT.EXE  program  manually,
  1269.      instead of through GT, the DTR should not be dropped when exiting from
  1270.      GT.  You may wish to do this if you don't have enough memory to run GT
  1271.      and PCKERMIT.EXE at the same time.
  1272.  
  1273.  
  1274.      RAM Disk Usage
  1275.      --------------
  1276.      Distributed  with the program is a file called RAMDISK.BAT.  It can be
  1277.      used to  install  and  run  the  program  from  a  RAM  disk.  To  use
  1278.      RAMDISK.BAT,  place  the  program disk in one of the floppy drives and
  1279.      make it the default, then enter the following command:
  1280.  
  1281.           RAMDISK d: e: [scr]      Where:   "d:"  is  the  drive  with  the
  1282.                                    program disk, "e:" is the RAM drive, and
  1283.                                    "[scr]" is an optional script file to be
  1284.                                    executed  on  start-up.  The brackets []
  1285.                                    just indicate that the  script  file  is
  1286.                                    optional.
  1287.  
  1288.           Example:  "RAMDISK A: C:"
  1289.  
  1290.                                    Additional  command line argument can be
  1291.                                    placed after the drive letters and  they
  1292.                                    will  be  passed as command line options
  1293.                                    to GT POWER within the batch run.
  1294.  
  1295.  
  1296.  
  1297.  
  1298.                                    - 22 -
  1299.  
  1300.  
  1301.      Coping With A Floppy Based System
  1302.      ---------------------------------
  1303.      It is obvious to the most casual observer that GT uses a lot  of  disk
  1304.      space.  So  how  does  one cope with a floppy based system?  The first
  1305.      rule is to place  the  files  that  cannot  be  directed  via  a  path
  1306.      designation onto drive A:.  Assuming the worst case, i.e.  you want to
  1307.      run the host mode from a floppy,  here is my  recommendation  for  the
  1308.      files that should be on drive A:
  1309.  
  1310.  
  1311.                               BULLET1.BBS
  1312.                               BULLET2.BBS
  1313.                               DSZ.EXE
  1314.                               GT.CNF
  1315.                               GT.DIR
  1316.                               GT.KEY
  1317.                               GT.LOG
  1318.                               GT.WIN
  1319.                               GT1600.EXE
  1320.                               GTBULLET.BBS
  1321.                               GTBYE.BBS
  1322.                               GTDIR.BBS
  1323.                               GTHELP.BBS
  1324.                               GTMDIR.BBS
  1325.                               GTMENU.BBS
  1326.                               GTNEWUSR.BBS
  1327.                               GTPASSWD.BBS
  1328.                               GTSYSID.BBS
  1329.                               GTUSER.BBS
  1330.                               GTWELCOM.BBS
  1331.                               PROTOCOL.BBS
  1332.                               SYSOP.BBS
  1333.                               ZMRX.BAT
  1334.                               ZMTX.BAT
  1335.  
  1336.  
  1337.      Now some of these files are  optional,  for  example  the  BULLET?.BBS
  1338.      files  are not normally required,  and the rest of the *.BBS files can
  1339.      be eliminated if the operator does not use host mode.
  1340.  
  1341.      The  USER.CTL  and USER.IDX files,  for host mode,  can be placed onto
  1342.      drive B:  by using the LAN PATH (don't worry about not having  a  LAN,
  1343.      but you will need to make GT think you do...  Use 0 for the pid number
  1344.      and any name will do for the pid name).
  1345.  
  1346.      We have included the DSZ program,  for its Zmodem protocol,  and  left
  1347.      PCKERMIT off.  But you might want both or PCKERMIT instead of DSZ.  In
  1348.      any case,  you must have the one you need.  However, it is possible to
  1349.      place one or both of these programs on drive B:  if you  set  you  DOS
  1350.      PATH to point at drive B:.
  1351.  
  1352.      Even  then,  you  must  be  careful that the log file does not grow to
  1353.      exceed the capacity of the disk.  The .DIR and  .KEY  files  can  also
  1354.      grow,  so a careful eye should be kept on the space available on drive
  1355.  
  1356.  
  1357.                                    - 23 -
  1358.  
  1359.  
  1360.      A:.
  1361.  
  1362.      It is not advisable for downloads or uploads to be done with drive A:,
  1363.      the configuration paths for downloads and uploads  should  be  set  to
  1364.      "B:\".  This  will  keep  the  rest of drive A:  free from these extra
  1365.      files.  Once mounted in drive A:,  this disk should remain  until  the
  1366.      program is exited.
  1367.  
  1368.      The message base file should be located on drive "B:\".  Use the setup
  1369.      option to declare the path for the message base to be drive "B:\".  It
  1370.      is under the miscellaneous options selection of the Alt-I screen.
  1371.  
  1372.      Of course,  you can save even more disk space by using the GTO version
  1373.      of the program.  The GTO version does not include a host  mode  module
  1374.      and thus saves more than 80k of disk space.
  1375.  
  1376.      If you have only 1 floppy disk, I wish you luck.  You won't have a lot
  1377.      of  space  to  play  with.  The best advice would be to purchase a 2nd
  1378.      disk at the earliest opportunity.  The  best  choice  would  be  a  20
  1379.      megabyte hard disk or bigger if the budget allows.
  1380.  
  1381.      A  reasonable  alternative  to  either  a second floppy or a hard disk
  1382.      would be one of the new 1.44 megabyte 3.5" diskette drives.
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.                                    - 24 -
  1417.  
  1418.  
  1419.      Computer To Computer Without Modems
  1420.      -----------------------------------
  1421.      If the  program  is  used  without  a  modem,  using  a  direct  cable
  1422.      connection,   all  the  dialing  and  modem  control  strings  in  the
  1423.      configuration file should be set to empty strings.  Also, when using a
  1424.      direct cable connection,  the "Carrier is Forced?" parameter should be
  1425.      set  to TRUE.  Also,  the command line switch,  /C,  should be used to
  1426.      indicate the direct connection to GT.
  1427.  
  1428.      When running a direct connection  via  cables,  with  one  of  the  GT
  1429.      systems operating in the host mode,  the operator on the terminal mode
  1430.      system can wake up the host system by striking carriage return.  NOTE:
  1431.      in this case both systems must be set to the same baud rate  ahead  of
  1432.      time.  The  host  system  will  use  the  default  baud  rate from the
  1433.      configuration file.  The terminal mode GT must use the same  rate,  if
  1434.      not  the  default,  then  set  the  required  baud rate with the Alt-S
  1435.      command.
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.                                    - 25 -
  1476.  
  1477.  
  1478.      Alt-Command Descriptions
  1479.      ------------------------
  1480.      Alt-A     ASCII transmission of a file using  the  XON/XOFF  protocol,
  1481.                where  the  DC1  character  is  used  for  XON  and  the DC3
  1482.                character is used for XOFF.  If the Pacing Character is set,
  1483.                then line-by-line pacing is also done, i.e. the program will
  1484.                wait for the pacing character to echo from the host  at  the
  1485.                end  of  each  line,  thereby insuring that an overrun error
  1486.                will not occur.  The default  is  not  to  use  line-by-line
  1487.                pacing.  Also associated with the ASCII file transmit is the
  1488.                End-of-Line Mode,  it determines what characters are sent to
  1489.                the host at the end of each  line.  The  normal  End-of-Line
  1490.                Mode  for  IBM  compatible  hosts is CRLF,  i.e.  a carriage
  1491.                return and a linefeed, however some hosts, for example UNIX,
  1492.                require just LF,  and others may require only  a  CR.  These
  1493.                are the three options for End-of-line Mode.  Also,  the user
  1494.                may specify an inter-character delay,  in milliseconds,  the
  1495.                default  delay is set to 0.  The Pacing Character,  the End-
  1496.                of-Line Mode and the inter-character delay,  are options  in
  1497.                the  configuration file.  Use the Alt-I command to alter the
  1498.                configuration.  The ASCII  inter-character  delay  adds  the
  1499.                indicated   number   of   milliseconds  delay  between  each
  1500.                character transmitted.  When uploading messages to IBM style
  1501.                BBS systems,  blank lines will cause a problem,  since  they
  1502.                will  cause the host system to terminate message input mode.
  1503.                This can be overcome by setting the Pad Blank Line parameter
  1504.                to TRUE.  All of these  parameters  are  located  under  the
  1505.                ASCII Xmit & Macro parameters of the Alt-I screen.
  1506.  
  1507.         +---------------------------------------------------------------+
  1508.         |                            NOTE                               |
  1509.         |                                                               |
  1510.         |        For uploading messages to most IBM style BBS's,        |
  1511.         |        you should use an End-of-Line mode of CR.              |
  1512.         |                                                               |
  1513.         +---------------------------------------------------------------+
  1514.  
  1515.      Alt-B     Send  BREAK  signal  to  host  computer.  The serial port is
  1516.                forced  into  the  spacing  state.   This  is  useful   when
  1517.                connected  to  some minicomputers that require the signal to
  1518.                wake-up and allow you to logon.  It is not  used  with  most
  1519.                BBS   systems.   The   length   of  the  BREAK  signal,   in
  1520.                milliseconds,  is configurable via the Miscellaneous Options
  1521.                of selection of the Alt-I screen.
  1522.  
  1523.      Alt-C     Turn  capture  mode  ON,  if it is OFF,  or OFF if it is ON.
  1524.                When this mode is  turned  OFF,  either  through  the  Alt-C
  1525.                command or with the Alt-X command, the user will be prompted
  1526.                for  a file name wherein to save the contents of the capture
  1527.                buffer.  During  capture  mode  operations,  a  number  will
  1528.                appear  in the lower left corner of the screen,  this is the
  1529.                number of characters,  in 1000's,  in  the  capture  buffer.
  1530.                Capture  mode  is useful for recording complete sessions for
  1531.                review later,  so you don't  read  so  much  on  those  long
  1532.  
  1533.  
  1534.                                    - 26 -
  1535.  
  1536.  
  1537.                distance phone calls.
  1538.  
  1539.                When the in-memory capture buffer is full,  the program will
  1540.                dump to a spill file on disk,  the file name  used  will  be
  1541.                $$SPILL.  The operation of the spill file is automatic,  but
  1542.                if the program is interrupted for some reason,  the file may
  1543.                remain  catalogued.  Therefore,  the user should remove this
  1544.                file when required.  It will be placed in the directory with
  1545.                the overlay files.  The size of the in-memory capture buffer
  1546.                is configurable,  in 1,000's of characters,  via  the  Alt-I
  1547.                screen.
  1548.  
  1549.                If  you  press Alt-C,  accidentally while capture mode is in
  1550.                progress,  you may continue capturing data by  pressing  the
  1551.                Esc key.
  1552.  
  1553.                Capture Header
  1554.                --------------
  1555.                Text  that  is  saved  after  a  capture session will have a
  1556.                header appended to it.  This header will name the last  host
  1557.                system called (if any) and the date and time the capture was
  1558.                done.  This will help you later,  especially if you 'append'
  1559.                multiple captures to one large file.  The headers  will  act
  1560.                as separators between various sessions.
  1561.  
  1562.      Alt-D     Modem  dialing  and  phone  directory management.  The phone
  1563.                directory may have up to 999 entries,  if  there  is  enough
  1564.                disk   space.   The   directory  screen  will  automatically
  1565.                disappear whenever a CONNECT type result  is  detected  from
  1566.                the modem.  Multiple phone directories are supported, to get
  1567.                more than 1 phone directory use the (E)xch command while the
  1568.                phone  directory is being displayed,  this will allow you to
  1569.                switch between directories.  Among other things,  the  phone
  1570.                directory  support  2 very important items:  A) personalized
  1571.                passwords,  and B)  default  transfer  protocol.  Using  the
  1572.                personalized  passwords,  one can store a different password
  1573.                for each host system listed and then access it automatically
  1574.                via a macro key when logging into each system.  A macro  key
  1575.                should be programmed with %P to enable it to send the proper
  1576.                password  for each system.  (Please refer to the description
  1577.                of the Alt-M below for a discussion of macro key setup.)  If
  1578.                you select a default transfer protocol for each entry in the
  1579.                phone directory,  then you will be able to eliminate several
  1580.                of the keystrokes required to start a file transfer,  as  GT
  1581.                will anticipate the selection of the protocol type.
  1582.  
  1583.      Alt-E     Turn Half Duplex ON if it is OFF,  or OFF if it is on.  Half
  1584.                duplex is used when the host does not echo what you type.  A
  1585.                Half  Duplex  indicator  will show on the bottom line of the
  1586.                screen, HDX,  when in this mode.  Also,  the duplex mode can
  1587.                be  set  automatically by entering that information into the
  1588.                Dialing Directory.
  1589.  
  1590.      Alt-F     Fix time.  That is,  mark the current time,  so that you can
  1591.  
  1592.  
  1593.                                    - 27 -
  1594.  
  1595.  
  1596.                measure time used, with the Alt-U command.
  1597.  
  1598.      Alt-G     Re-dial the last  number  dialed.  This  command  will  loop
  1599.                continuously until a CONNECT is signaled by the modem or the
  1600.                user  presses  <Esc>  to  quit.  The user may press N)ext to
  1601.                force the program to perform  a  quick  re-dial.  The  Alt-I
  1602.                configuration contains an option to enable automatic redial.
  1603.  
  1604.      Alt-H     Produces the HELP screen for the user.
  1605.  
  1606.      Alt-I     Reconfigure  the  program  defaults.  The  parameters listed
  1607.                below, in the Appendix, for the .CNF file can be changed via
  1608.                this command.
  1609.  
  1610.      Alt-J     Display version and serial number  of  GT  in  use  and  the
  1611.                amount of free memory left for GT to use.
  1612.  
  1613.      Alt-K     Kill a file.  Delete a file from the disk.
  1614.  
  1615.      Alt-L     Display disk directory,  under a  user  supplied  mask.  For
  1616.                example, to see all files with a PAS extension on the logged
  1617.                drive  and current directory,  the user would enter the mask
  1618.                "*.PAS",  when prompted.  Or see  just  the  files  with  an
  1619.                extension  of .C by entering the mask "*.c",  when prompted.
  1620.                By default,  the program will show all files,  if no mask is
  1621.                entered by the user.
  1622.  
  1623.      Alt-M     Macro  key  management.   Allows  the  user  to  define  the
  1624.                contents  of  the  function  keys  F1  through  F10  (F12 on
  1625.                enhanced keyboards),  and all combinations of  the  function
  1626.                keys  and  Shift,  Ctrl  or  Alt.  This  gives  the  user 40
  1627.                different  macro  keys.   The  password,   from  the   phone
  1628.                directory,  may  be  stored  in  a  macro key by putting the
  1629.                characters %P into one of the keys,  then whenever that  key
  1630.                is  struck the password for the currently connected BBS will
  1631.                be transmitted.  For example,  I put my name  into  F1,  the
  1632.                letter Y into F2 and my password into F3.  Like this:
  1633.  
  1634.                                 F1 = Paul|~Meiners|
  1635.                                 F2 = Y|
  1636.                                 F3 = %P|
  1637.  
  1638.        Note:   These 3 items could just as easily have been placed  into  1
  1639.                macro key, like this:
  1640.  
  1641.                                 F1 = Paul|~Meiners|~Y|~%P|
  1642.  
  1643.                The | character is entered into a macro key when you want GT
  1644.                to  send  a  carriage return,  a ~ is used when you want a 1
  1645.                second delay,  and a ;  is used when you wish to  include  a
  1646.                comment in the macro key.  The ;  character is configurable,
  1647.                in case you need to include it in the  macro  key.  Use  the
  1648.                Alt-I command to setup GT for your requirements.
  1649.  
  1650.  
  1651.  
  1652.                                    - 28 -
  1653.  
  1654.  
  1655.                With enhanced keyboards,  i.e. those having 12  Fn keys,  GT
  1656.                can support up to 48 different macro keys!
  1657.  
  1658.                Each  entry  in  the  phone  directory  can have a different
  1659.                password associated with  it,  so  you  can  customize  your
  1660.                passwords  for  each  BBS you call.  Makes things a lot more
  1661.                secure and easier to manage.
  1662.  
  1663.                Control characters can also be  placed  into  a  macro  key.
  1664.                Normally, you can use the Alt key and the numeric keypad, if
  1665.                you know the ASCII code for the character, however there are
  1666.                some  control  codes  that  cannot be placed directly into a
  1667.                macro key,  such as Ctrl-Z.  To put a Ctrl-Z,  or any  other
  1668.                control  character  into  a  macro,  you enter a % character
  1669.                followed by  the  decimal  value  of  its  ASCII  code.  For
  1670.                example  the Ctrl-Z would be %26.  The value following the %
  1671.                may not exceed 255 -the maximum value of any one character.
  1672.  
  1673.                The transmission rate of characters from the macro  keys  is
  1674.                configurable.  The  "Macro  character  delay"  under  Alt-I,
  1675.                ASCII  Xmit  &  Macro  parameters,   is  used  to  pace  the
  1676.                transmission of these keystrokes.
  1677.  
  1678.                Keyboard Macros
  1679.                ---------------
  1680.                Beginning with GT POWER 14.00, the macro keys can be used as
  1681.                full  fledged  'keyboard  macros'.  This  means  that beyond
  1682.                storing logons and other simple phases, they can now be used
  1683.                to ease the operation of the  program  itself!  Any  command
  1684.                that  you can give GT from the keyboard can be stored in one
  1685.                of these keys.  Plus there are some commands that  can  only
  1686.                be  executed  via  a  macro  key.  Here  are  some rules for
  1687.                constructing keyboard macros:
  1688.  
  1689.                The { and } characters are used  to  denote  a  special  key
  1690.                sequence to the macro processor.  For example:  {HOME} would
  1691.                denote a strike of the 'Home' key.  Also,  'Alt'  keystrokes
  1692.                can  be  issued in the same fashion,  for example {@-} would
  1693.                indicate the 'Alt -' keystroke.  The sequence {?} is used to
  1694.                solicit input from the user.  For example,  {@L}*.doc| would
  1695.                cause the Alt-L command to list all DOC files in the current
  1696.                directory.
  1697.  
  1698.                There  are  some  commands  that  can only be accessed via a
  1699.                macro key (we ran out of other command keys!).  Here is  the
  1700.                list:
  1701.  
  1702.                {@=}      Execute  a  DOS command.  Nifty way to execute any
  1703.                          DOS program or command (such  as  a  text  editor)
  1704.                          with one keystroke.  For example:
  1705.  
  1706.                                    {@=}qed|
  1707.  
  1708.                          This would execute the 'qed' program and return to
  1709.  
  1710.  
  1711.                                    - 29 -
  1712.  
  1713.  
  1714.                          GT when finished.
  1715.  
  1716.                                    {@=}{?}|
  1717.  
  1718.                          This would execute any program that the user named
  1719.                          when prompted for input.
  1720.  
  1721.                {@>}      Start  the  recording  of all keystrokes for later
  1722.                          playback.  For example:
  1723.  
  1724.                                    {@>}foo.mac|
  1725.  
  1726.                          When  executed,   this  macro  would   cause   all
  1727.                          following   keystrokes   to  be  recorded  in  the
  1728.                          'foo.mac' file.
  1729.  
  1730.                {@.}      Stop the recording of keystrokes.  Once  recording
  1731.                          has  been  started,  this  command  will  stop the
  1732.                          recording and close  the  macro  file  named  when
  1733.                          recording started.
  1734.  
  1735.                {@<}      Start  the  playback  of  the  keystrokes previous
  1736.                          recorded in a macro file.  For example:
  1737.  
  1738.                                    {@<}{?}|
  1739.  
  1740.                          This would execute any macro file  that  the  user
  1741.                          named when prompted for input.
  1742.  
  1743.                {@;}      This  command  toggles  the  update  of the status
  1744.                          line.  The command is useful for  people  who  are
  1745.                          using  "text  to  voice" equipment,  if the status
  1746.                          line is continually updated the voice  output  can
  1747.                          be quite a nuisance.
  1748.  
  1749.                Extended  keys  can also be represented via keyboard macros.
  1750.                We have already seen how the Alt keys  can  be  represented,
  1751.                Alt-A  is  {@A} for example,  but other extended keys can be
  1752.                issued also.  Here is a list of the  available  symbols  for
  1753.                use:
  1754.  
  1755.                          {UP}      Up Arrow key.
  1756.                          {DOWN}    Down Arrow key.
  1757.                          {LEFT}    Left Arrow key.
  1758.                          {RIGHT}   Right Arrow key.
  1759.                          {HOME}    Home key.
  1760.                          {END}     End key.
  1761.                          {^END}    Ctrl-End key combination.
  1762.                          {PGUP}    PgUp key.
  1763.                          {PGDN}    PgDn key.
  1764.                          {INS}     Ins key.
  1765.                          {DEL}     Del key.
  1766.                          {BS}      Backspace key.
  1767.                          {ESC}     Esc key.
  1768.  
  1769.  
  1770.                                    - 30 -
  1771.  
  1772.  
  1773.                          {TAB}     Tab key.
  1774.                          {BTAB}    Backward Tab key. (Shift Tab).
  1775.                          {^PRT}    Ctrl-Prt key combination.
  1776.                          {NUL}     The 'nul' character.  Binary zero.
  1777.  
  1778.                The  F keys themselves can be indicated within a macro.  For
  1779.                example {F1} would be a press of the F1 key.  {^F1} would be
  1780.                a press of the Ctrl-F1 key.  {@F1} would a press of the Alt-
  1781.                F1 key.  And {$F1} would be a Shift-F1 key press.  Including
  1782.                an F key press in a macro key acts as a GOTO for  the  macro
  1783.                execution, no nesting of macros is done.
  1784.  
  1785.                In  addition  to  the old subtitutions that can be made in a
  1786.                macro key, such as the %P for the password, the user may now
  1787.                use the following:
  1788.  
  1789.                          %C        COM port number.
  1790.                          %B        Baud rate.
  1791.                          %P        Current BBS password.
  1792.                          %N1       Comment #1.
  1793.                          %N2       Comment #2.  It is very handy to be able
  1794.                                    use   the   comments   from   the  phone
  1795.                                    directory  in  this  manner,  especially
  1796.                                    when  calling  systems that require more
  1797.                                    than 1  password.  The  extra  passwords
  1798.                                    can  be  stored  in  the phone directory
  1799.                                    comment fields  and  sent  automatically
  1800.                                    from a macro key.
  1801.                          %R        Substitutes  to  'ctty'  when   executed
  1802.                                    remotely, or 'rem' when done local.
  1803.                          |         Carriage return.
  1804.                          ~         Delay for a second.
  1805.                          %nn       Represent any  ASCII  keystroke  by  its
  1806.                                    decimal value.
  1807.  
  1808.      Alt-N     Allows  the  user to change to a new logged drive and/or new
  1809.                working directory.
  1810.  
  1811.      Alt-O     Sort the dialing directory into ascending sequence by  name,
  1812.                number, date, times on, elapsed time or baud rate.  Performs
  1813.                an  IN  MEMORY sort,  so there must be enough memory to hold
  1814.                all the phone directory entries.
  1815.  
  1816.      Alt-P     Print  a  file.  Configuration  options,  under  Alt-I,  are
  1817.                available to enable pagination of the printed output and the
  1818.                number of lines per page.
  1819.  
  1820.      Alt-Q     Hang-up the phone line,  put the modem "ON HOOK".  If  there
  1821.                is a "Hang-up String" defined in the configuration file,  it
  1822.                is sent to the modem,  otherwise the DTR signal to the modem
  1823.                is  dropped  for  a second and then the modem initialization
  1824.                string is sent to the modem.
  1825.  
  1826.      Alt-R     Receive a file using either the default protocol  listed  in
  1827.  
  1828.  
  1829.                                    - 31 -
  1830.  
  1831.  
  1832.                the   phone   directory   or   one   chosen   from  a  menu.
  1833.                Communications parameters are automatically changed  to/from
  1834.                8  bit no parity,  and the 8th bit stripping is disabled for
  1835.                the duration of the transfer.  CRC is used automatically, if
  1836.                the remote system supports it.  When using a batch protocol,
  1837.                the names of the files will be supplied by the host.  If the
  1838.                carrier signal from the host is lost during  file  transfer,
  1839.                the  alarm  will  sound  and  the "Carrier Loss" window will
  1840.                open.  The alarm will  continue  to  sound  until  the  user
  1841.                strikes a key.
  1842.  
  1843.        Note:   If VT-100 and/or VT-52 emulation mode is not being used, the
  1844.                <PgDn> key may be used instead of <Alt-R>.
  1845.  
  1846.        Note:   For proper operation of  external  transfer  protocols,  the
  1847.                related  EXE  and  BAT files must be available in one of the
  1848.                places pointed to by the DOS PATH variable.
  1849.  
  1850.      Alt-S     Switch communication parameters.  The  program  starts  with
  1851.                the  default  values.  Permissible  values for the baud rate
  1852.                are:  300, 1200, 2400,  4800,  9600,  19200,  38400 or 115k.
  1853.                Note: the PCjr does not operate at speeds above 4800 baud.
  1854.  
  1855.      Alt-T     Transmit a file using either the default protocol listed  in
  1856.                the   phone   directory   or   one   chosen   from  a  menu.
  1857.                Communications parameters are automatically changed  to/from
  1858.                8  bit no parity,  and the 8th bit stripping is disabled for
  1859.                the duration of the transfer.  CRC is used,  if  the  remote
  1860.                system  requests  it.  When  using  a batch protocol,  it is
  1861.                possible to transfer many files at one time (limited only by
  1862.                available memory  to  store  the  filenames).  If  the  user
  1863.                wishes  to  perform  a  batch transfer,  he must specify the
  1864.                names of the  files  to  transfer  using  the  DOS  wildcard
  1865.                notation;  for example,  to transfer all files with the .PAS
  1866.                extension,  when  asked  for  the  filename,   respond  with
  1867.                "*.PAS".  A  drive and path may optionally be specified with
  1868.                the filename.  The files found matching the  criterion  will
  1869.                be transmitted.  If the carrier signal from the host is lost
  1870.                during file transfer,  the alarm will sound and the "Carrier
  1871.                Loss" window will open.  The alarm will  continue  to  sound
  1872.                until the user strikes a key.
  1873.  
  1874.                The Pick List
  1875.                -------------
  1876.                When the transmit command is invoked, the user will have the
  1877.                opportunity to select a 'pick list'.  When  prompted  for  a
  1878.                filename,  the user may type a file select mask, for example
  1879.                *.arc and press the <Tab> key  instead  of  instead  of  the
  1880.                carriage  return.  This  will  produce  a sorted 'pick list'
  1881.                from which the user can select the files to be  transmitted.
  1882.                The  arrow  and other direction keys can be used to navigate
  1883.                the list,  the carriage return will mark  entries,  and  the
  1884.                <Esc>  key  will start the transmission.  Of course,  all of
  1885.                this assumes that you are using one of the batch  protocols,
  1886.  
  1887.  
  1888.                                    - 32 -
  1889.  
  1890.  
  1891.                like  MegaLink.  The marked entries will be transmitted,  if
  1892.                no  entries  are  marked,   then  GT  will  not  perform   a
  1893.                transmission.  The  'pick  list'  functions  only  with  the
  1894.                protocols built into GT.
  1895.  
  1896.        Note:   If VT-100 and/or VT-52 emulation mode is not being used, the
  1897.                <PgUp> key may be used instead of <Alt-T>.
  1898.  
  1899.        Note:   For proper operation of  external  transfer  protocols,  the
  1900.                related  EXE  and  BAT files must be available in one of the
  1901.                places pointed to by the DOS PATH variable.
  1902.  
  1903.      Alt-U     Used time.  Report  the  time  used  since  the  last  ALT-F
  1904.                command  and  the last dial of the phone or the start of the
  1905.                program,  whichever occurred last.  Total  elapsed  time  in
  1906.                hours minutes and seconds, is reported.
  1907.  
  1908.      Alt-V     View  the  contents of a file,  uses the same style as MORE,
  1909.                the DOS utility.  Use the <Esc> key to stop the command.
  1910.  
  1911.      Alt-W     Clear the screen.
  1912.  
  1913.      Alt-X     Terminate and return to DOS.  If a script  is  active,  this
  1914.                command   will  not  be  effective  until  all  scripts  are
  1915.                finished.  If the script is currently at an ONLINE  command,
  1916.                then  Alt-X will cause termination of the ONLINE command and
  1917.                return control to the script.  To exit the script you should
  1918.                press the <Esc>  key  after  the  ONLINE  command  has  been
  1919.                terminated.
  1920.  
  1921.      Alt-Y     Copy a file.  This procedure will copy any unprotected file.
  1922.                Filenames   must  be  fully  specified.   No  wildcards  are
  1923.                allowed,  ONLY the current drive and directory need  not  be
  1924.                specified.
  1925.  
  1926.      Alt-Z     Toggle monitor mode on/off.  In monitor mode,  all codes are
  1927.                shown so that the user may see exactly what is being sent by
  1928.                the host computer.  Control  codes  are  shown  with  the  ^
  1929.                symbol  preceding,  i.e.  ^[ is the ESC code,  ^X is the CAN
  1930.                code,  etc.  You must refer to an ASCII  code  chart  for  a
  1931.                complete list.
  1932.  
  1933.      Alt-1     DOS Shell port.  GT stays in the background,  while you exit
  1934.                to  DOS.  When  you  want  to  return to GT,  just issue the
  1935.                "EXIT" command and you will return to GT.  Note:  you need a
  1936.                lot of memory to do this, more than 400k is recommended.
  1937.  
  1938.      Alt-2     Dump  screen  to  the  file "$$SCREEN".  If the file already
  1939.                exists,  then the screen is appended to the file,  otherwise
  1940.                the file is created and the screen written to it.
  1941.  
  1942.      Alt-3     Execute  a  script.  Scripts may also be executed by placing
  1943.                the name of the script file on the  DOS  command  line  that
  1944.                starts GT.  For example: "A>GT1600 filename", would begin GT
  1945.  
  1946.  
  1947.                                    - 33 -
  1948.  
  1949.  
  1950.                and   cause   the   script   stored  in  filename  to  begin
  1951.                automatically.  Refer  to  the  description  of  the  script
  1952.                language at the end of this document.
  1953.  
  1954.                To  execute  a  script via a macro key,  place the following
  1955.                string of characters into a macro key.
  1956.  
  1957.                     {@3}foo.scr|
  1958.  
  1959.                Where 'foo.scr' represents the name  of  any  valid  script.
  1960.                Using this technique,  it is possible to have easy access to
  1961.                many of your script files.
  1962.  
  1963.      Alt-4     Suspends capture mode, if it is active.  While suspended you
  1964.                may  hit  Alt-4  again  to  resume  capturing  or  Alt-C  to
  1965.                terminate  capture  mode.  Useful when you wish to append to
  1966.                the capture buffer from selected sources.
  1967.  
  1968.      Alt-5     This option is used to force GT to  use  "checksum"  as  the
  1969.                default  Xmodem protocol.  This avoids the pitfalls of using
  1970.                CRC protocols with non-standard  systems.  Very  useful  for
  1971.                transferring files with older systems or non-IBM systems.
  1972.  
  1973.      Alt-6     Begins  execution  of  the  "circular  dialing"  queue.  All
  1974.                "marked" entries in the phone directory will be  dialed  in-
  1975.                turn,  until  a  connection  is  made  or the user stops the
  1976.                execution by  pressing  <Esc>.  Individual  entries  may  be
  1977.                canceled by pressing <C>, while the entry is being processed
  1978.                on the screen.  The user may immediately proceed to the next
  1979.                entry in the queue by pressing the <N>.  The user can repeat
  1980.                the  dialing  of  the  current  number,  if  found busy,  by
  1981.                pressing  the  <R>.   Use  the  <G>  command  on  the  Phone
  1982.                Directory  screen to "mark" entries for the circular dialing
  1983.                queue.  See explanation  of  the  Phone  Directory  commands
  1984.                below.
  1985.  
  1986.      Alt-7     This  key  acts  as a toggle to begin/end split screen mode.
  1987.                During split screen operation whatever the user  types  will
  1988.                appear  at  the  bottom  of  the screen and will be buffered
  1989.                until a carriage return is struck.
  1990.  
  1991.      Alt-8     Review  the  in-memory  portion  of the capture buffer.  The
  1992.                <PgUp>,  <PgDn>,  <Home> and <End> keys may be used to  move
  1993.                around  in  the  buffer.  <PgUp> and <PgDn> move through the
  1994.                buffer a page at a time,  the <Home> and <End> keys move you
  1995.                to  the  start  or  end of the buffer.  Use the <Esc> key to
  1996.                quit viewing the buffer.  The L)ocate command  is  activated
  1997.                by  pressing  the <L> key.  It may be used to locate text in
  1998.                the capture buffer below the current location.  If a find is
  1999.                made,  the text will be moved to the top of the screen.  The
  2000.                <Up-Arrow>  and  <Dn-Arrow>  keys  may be used to scroll one
  2001.                line at a time.
  2002.  
  2003.      Alt-9     Toggle the beeps on/off.  Go into  quiet  mode  or  back  to
  2004.  
  2005.  
  2006.                                    - 34 -
  2007.  
  2008.  
  2009.                normal  mode.  Does  not  change the playing of music or the
  2010.                window whistle (which are both controlled via  configuration
  2011.                options),  just the bell.  To control the window whistle and
  2012.                music playing refer to the miscellaneous section  under  the
  2013.                Alt-I command.
  2014.  
  2015.      Alt-0     Make  a manual entry in the Log file.  Log file must be open
  2016.                before you can make entries.  Open the Log file  by  setting
  2017.                the  Log  file flag = TRUE on the configuration screen.  See
  2018.                the Alt-I command.
  2019.  
  2020.      Alt -     The program will enter host mode and await incoming calls.
  2021.  
  2022.      ^PrtSc    Toggle the printer ON/OFF.  Press the <Ctrl-PrtSc> key.  Use
  2023.                <Fn-Echo> on the PCjr.
  2024.  
  2025.      ^Down     The <Ctrl-DownArrow> key is used to toggle  the  Transparent
  2026.                Mode.  In  Transparent  Mode,  all  of  the  ALT and Fn keys
  2027.                transmit their  extended  keycodes  to  the  host  computer,
  2028.                instead  of  being  executed as command keys for GT.  During
  2029.                Transparent Mode operations only the <Ctrl-Dn> key  will  be
  2030.                recognized by GT.  Also during Transparent Mode,  the screen
  2031.                will automatically be placed into full screen 25 line  mode.
  2032.                This  mode  is  extremely useful when trying to run programs
  2033.                remotely with such programs as DoorWay are  in  use  by  the
  2034.                host computer.
  2035.  
  2036.      ^Home     The  <Ctrl-Home>  key  is used to toggle full screen 25 line
  2037.                mode.  Unlike the Transparent Mode,  all  ALT  and  Fn  keys
  2038.                continue  to  act  like  GT command keys.  This mode is very
  2039.                handy when reading messages on a BBS and you need  a  little
  2040.                extra room on the screen.
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.                                    - 35 -
  2066.  
  2067.  
  2068.      Phone Directory Commands
  2069.      ------------------------
  2070.           A =  Add an entry to the dialing directory.
  2071.  
  2072.           C =  Change an entry in the dialing directory.  Whenever an entry
  2073.                is added or changed in the phone directory, the user will be
  2074.                asked to enter a password which can be used by placing a  %P
  2075.                in a macro key.
  2076.  
  2077.           K =  Kill  an  entry  in  the  dialing directory,  sorting of the
  2078.                directory is  recommended  after  this  option  or  the  Add
  2079.                option.
  2080.  
  2081.  
  2082.      L =    Locate a BBS by name.  You may specify partial  names  and  the
  2083.             search  is not sensitive to capital letters.  The search begins
  2084.             with the current directory screen and proceeds to  the  end  of
  2085.             the directory.
  2086.  
  2087.      N =    Find  the  next occurrence of the last BBS requested in the <L>
  2088.             command,  above.  The search begins where the  previous  search
  2089.             left off and finds the next match, if any.
  2090.  
  2091.      M =    Dial  a  number not in the directory.  The user is prompted for
  2092.             new communications parameters.
  2093.  
  2094.      Entry number =
  2095.             Dial  one  of  the  entries   in   the   directory.   GT   will
  2096.             automatically   change   the   communications  parameters.   To
  2097.             indicate  that  the  phone  number  needs  to  be  prefixed  or
  2098.             suffixed,  put one of the prefix characters before or after the
  2099.             number.  The 6 prefix characters are: -  +  *  !  ? and &.  The
  2100.             actual prefix and suffixes must be setup via the Alt-I command.
  2101.  
  2102.             Usage:
  2103.  
  2104.             -74   would cause the 74th number in the directory to be dialed
  2105.                   with the prefix associated with the -.
  2106.  
  2107.             +81!  would cause the 81st number in the directory to be dialed
  2108.                   with the prefix associated with  the  +  and  the  suffix
  2109.                   associated with the !.
  2110.  
  2111.             On  occassion  it  may  be necessary to actually use one of the
  2112.             prefix characters as a part of the phone number.  For  example,
  2113.             '*70,'  is often used to disable the Call Waiting feature.  The
  2114.             correct procedure is to put the '*70,' in a  prefix  character,
  2115.             put  that prefix character before the phone number in the phone
  2116.             directory and then let GT insert it before dialing.  If this is
  2117.             not done, GT will remove the '*' character (confusing it with a
  2118.             prefix character) and replace it with whatever is contained  in
  2119.             the  '*'  prefix  (perhaps  that  prefix is empty,  so GT would
  2120.             simply remove the '*').
  2121.  
  2122.  
  2123.  
  2124.                                    - 36 -
  2125.  
  2126.  
  2127.      G =    Mark  a  BBS  for  entry into the "circular" dialing queue.  If
  2128.             already marked,  the mark will be  removed.  So,  this  command
  2129.             acts  as  a toggle between the marked and unmarked state.  When
  2130.             using this command,  if the user responds  with  "CLEAR",  when
  2131.             asked for the BBS number,  all marks will be cleared.  The user
  2132.             may enter a list of BBS's to be marked or cleared by separating
  2133.             each number from the next with either a  space  or  comma.  For
  2134.             example:  "22,30,40"  could  be  entered when responding to the
  2135.             request for BBS No's.  The user may also respond with the  word
  2136.             "ALL",  in  which  case  all  entries  will be marked.  And the
  2137.             lastly the user may enter a range of numbers.
  2138.  
  2139.             For example:
  2140.  
  2141.                 22 30-40 55    would mark 22, the range 30 to 40, & 55.
  2142.  
  2143.      E =    Exchange the current directory with another one.  For  example,
  2144.             one  could  have  two directories,  1 for local BBS's and 1 for
  2145.             long distance calls.  Don't give  any  path  information,  when
  2146.             entering  the  filename  this  option  calls  for  -  ALL phone
  2147.             directories are located using the  "Directory  PATH"  from  the
  2148.             configuration  file.  Use the Alt-I command to set this path as
  2149.             required.
  2150.  
  2151.      T =    Toggle the display, between the call count and accumulated time
  2152.             display, and the display of the date and time of the last call.
  2153.             There are 4 different displays possible to view  with  the  "T"
  2154.             command.
  2155.  
  2156.             NOTE:  The  Left-Arrow  and  Right-Arrow  keys  serve  the same
  2157.                    function as the "T" command.
  2158.  
  2159.      Esc =  Quit, returns to the online screen.
  2160.  
  2161.      PgDn = Display the next page of the directory.
  2162.  
  2163.      PgUp = Display the previous page of the directory.
  2164.  
  2165.      Home = Go to the first page of the directory.
  2166.  
  2167.      End =  Go to the last page of the directory.
  2168.  
  2169.      Up-Arrow =
  2170.             Move highlight to entry above the current highlighted entry.
  2171.  
  2172.      Dn-Arrow =
  2173.             Move highlight to entry below the current highlighted entry.
  2174.  
  2175.      Return =
  2176.             Dial the entry currently highlighted.
  2177.  
  2178.      Spacebar =
  2179.             Marks the entry that is currently highlighted for  use  by  the
  2180.             circular  dialing  routine.  Similar  in  function  to  the 'G'
  2181.  
  2182.  
  2183.                                    - 37 -
  2184.  
  2185.  
  2186.             command above.
  2187.  
  2188.      Also,  one  may execute several of the Alt commands directly while the
  2189.      Phone Directory is still on  the  screen.  For  example,  you  may  go
  2190.      directly  to  the Circular Dialer by pressing Alt-6.  Ordinarily,  the
  2191.      only Alt commands that are not available while in the Phone  Directory
  2192.      are those that would be executed while on-line,  for example the Alt-T
  2193.      command would make no sense while still in the Phone Directory.
  2194.  
  2195.      The phone directory was expanded  in  GT  11.00  to  include  two  new
  2196.      fields:  the  logon script and the default file transfer protocol.  If
  2197.      the logon script is filled, then the indicated script will be executed
  2198.      whenever a connection is made with the  associated  BBS.  The  default
  2199.      file  transfer  protocol,  if  specified,  will  be automatically used
  2200.      whenever doing a file transfer with the associated BBS.
  2201.  
  2202.      The phone directory was again expanded  in  GT  15.00.  This  time  to
  2203.      include three new options:  duplex (full or half),  emulation mode and
  2204.      8th bit stripping.  These fields may be in one of three states:  TRUE,
  2205.      FALSE  or  empty.  If  they are empty,  then GT will leave the default
  2206.      settings in effect.  The emulation mode may  also  contain  'VT52'  to
  2207.      indicate that VT-52 emulation is to be performed.
  2208.  
  2209.      The  phone  directory  was  expanded  again in GT 15.50.  This time to
  2210.      include the Dial Script and the  PCP  City.  If  the  Dial  Script  is
  2211.      filled  with  the name of a script,  when GT is instructed to dial the
  2212.      entry control will be passed to that script, instead of having GT dial
  2213.      the number itself.  This  is  very  useful  in  situations  where  the
  2214.      dialing  procedure is extremely complicated,  and the built-in dialing
  2215.      procedures are inadequate -- for example,  when trying to dial through
  2216.      a 3rd party long distance carrier, such as PC Pursuit.
  2217.  
  2218.      A Dial Script must end in a special manner,  via the SET ONLINE script
  2219.      command.  The script must use this command to return control to GT and
  2220.      to inform GT whether or not a connection with the destination has been
  2221.      successfully accomplished.  For example:
  2222.  
  2223.                                 SET ONLINE true
  2224.  
  2225.      Would terminate the Dial Script  and  inform  GT  that  a  successfull
  2226.      connection has been established.  On the other hand:
  2227.  
  2228.                                 SET ONLINE false
  2229.  
  2230.      Would  terminate the Dial Script and inform GT that a connection could
  2231.      not be successfully established.
  2232.  
  2233.      Dial Scripts have several variables passed in from the phone directory
  2234.      to enable their operation:
  2235.  
  2236.         %NUM        This is a string variable within which  GT  will  place
  2237.                     the  ready  to  be dialed phone number.  For example it
  2238.                     might contain "ATDT123-4567".  Besides being set GT for
  2239.                     Dial Scripts,  this variable is also set by the  script
  2240.  
  2241.  
  2242.                                    - 38 -
  2243.  
  2244.  
  2245.                     command FETCH.
  2246.  
  2247.         %CITY       This  is  a  string variable within which GT will place
  2248.                     the contents  of  the  PCP  City  field  in  the  phone
  2249.                     directory.  As with the %NUM variable, this variable is
  2250.                     also set by the script command FETCH.
  2251.  
  2252.         %BUSY       Within  a Dial Script the DIALER command may be used to
  2253.                     dial the entry automatically from the phone  directory.
  2254.                     If the DIALER command fails to connect,  i.e.  if %FAIL
  2255.                     is TRUE,  then it is possible for the script to examine
  2256.                     the  boolean variable %BUSY,  to see if the failure was
  2257.                     due to a busy condition.  If the busy result was found,
  2258.                     then the script can choose  to  redial  after  a  small
  2259.                     interval via the DIALER command.
  2260.  
  2261.         %NAME       This  is  a  string variable within which GT will place
  2262.                     the  name  of  the  entry  selected  from   the   phone
  2263.                     directory.
  2264.  
  2265.      The following is an extremely simple example of a Dial Script:
  2266.  
  2267.              writeln "Attempting to dial '" %NAME "' !!!"
  2268.              dialer
  2269.              case %FAIL
  2270.                 TRUE
  2271.                    goto BUSY
  2272.              esac
  2273.              writeln "Success!"
  2274.              twait 1000
  2275.              set online true
  2276.              :BUSY
  2277.              case %BUSY
  2278.                 TRUE
  2279.                    writeln "The line was busy..."
  2280.                    twait 1000
  2281.                    set online false
  2282.              esac
  2283.              writeln "Failed to make connection... don't know why!"
  2284.              twait 1000
  2285.              set online false
  2286.  
  2287.      Remember,  Dial  Scripts  *must*  always  terminate  with a SET ONLINE
  2288.      statement,  which serves two functions:  (1) to return control to  GT,
  2289.      and (2) to let GT know the result of your dialing efforts.
  2290.  
  2291.  
  2292.      Scripts  may be linked  to entries in  the phone directory  that don't
  2293.      have  phone  numbers.  When such an entry is selected,  the associated
  2294.      logon script is executed.  This acts as a menu for scripts!
  2295.  
  2296.  
  2297.      Editing Keys
  2298.      ------------
  2299.  
  2300.  
  2301.                                    - 39 -
  2302.  
  2303.  
  2304.      When  editing  Phone  Directory  entries,   Macro   Key   definitions,
  2305.      configuration  setup  entries  and  all  other text type entries,  the
  2306.      program responds to the following editing keys as indicated:
  2307.  
  2308.           Backspace .... Delete character to the left of cursor.
  2309.  
  2310.           Del .......... Delete character under the cursor.
  2311.  
  2312.           End .......... Move the cursor to the end of the field.
  2313.  
  2314.           Ctrl-End ..... Erase from the current cursor position to the  end
  2315.                          of the field.
  2316.  
  2317.           Home ......... Move the cursor to the start of the field.
  2318.  
  2319.           Ctrl-Home .... Erase  the current field entirely,  no matter what
  2320.                          the current cursor position is within the field.
  2321.  
  2322.           Ins .......... Toggle between insert and overwrite mode.  When in
  2323.                          insert mode the cursor becomes fat.
  2324.  
  2325.           Left Arrow ... Move the cursor to the left 1 position.
  2326.  
  2327.           Right Arrow .. Move the cursor to the right 1 position.
  2328.  
  2329.           Return ....... Finish the current field and move to the next.
  2330.  
  2331.           Esc .......... Terminate edit.  Saves the changes made thus far.
  2332.  
  2333.  
  2334.  
  2335.  
  2336.  
  2337.  
  2338.  
  2339.  
  2340.  
  2341.  
  2342.  
  2343.  
  2344.  
  2345.  
  2346.  
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.                                    - 40 -
  2361.  
  2362.  
  2363.      Host Mode
  2364.      ---------
  2365.      The setup for host mode is complicated enough that a separate document
  2366.      file has been written describing this procedure.  Rest  assured,  that
  2367.      once the proper setup has been achieved,  GT should operate with ease,
  2368.      both in and out of host mode.  Refer to  the  file  GTHOST.DOC  for  a
  2369.      complete  description  of  the  host  mode  and  to  NETMAIL.DOC for a
  2370.      description of the GT netmail system (please look in the ADDENDUM.NET
  2371.      file for many of the new features of the netmail system).
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385.  
  2386.  
  2387.  
  2388.  
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.                                    - 41 -
  2420.  
  2421.  
  2422.      Scripts
  2423.      -------
  2424.      The script language allows the user to automate most of  the  features
  2425.      of  GT.  Following  is  a  description  of the script syntax.  Several
  2426.      preliminary comments about scripts:  1) a script can  be  canceled  by
  2427.      hitting <Esc>,  2) the CYCLE command can be stopped by pressing <Ctrl-
  2428.      K>,  3) the strings and other literal information in the syntax should
  2429.      be enclosed within "..." if they contain white-space,  blanks, tabs or
  2430.      commas,  otherwise they need  not  be  so  enclosed.  All  fields  and
  2431.      operators must be separated on the line by the use of white-space.
  2432.  
  2433.      Scripts are interactive,  so that the user can modify them on-the-fly.
  2434.      In order to do this, 30 variables have been setup,  they are called V0
  2435.      through  V29.  They  are  referenced  in either assignment statements,
  2436.      READLN or GETLN statements.  In order to use them,  a technique called
  2437.      "variable  substitution"  is  used.  Instead  of  the V,  the variable
  2438.      number is prefixed with a %,  thus V0 through V29,  become %0  through
  2439.      %29.  Variable  substitution  may not be done within "...",  since the
  2440.      contents of a variable is considered to be a field,  i.e.  you  cannot
  2441.      build  a  field from several concatenated variable substitutions.  For
  2442.      example:  %1%2 would be invalid.  It is not possible  to  do  variable
  2443.      substitution within "...", for example: "%2" is not valid.  If you use
  2444.      a  variable  that has not been initialized,  it will be a null string.
  2445.      The data in variables is stored as strings of  characters,  up  to  78
  2446.      characters long.
  2447.  
  2448.      I used the word "field" in the paragraph above, by it I mean that part
  2449.      of  a  script  command that either is enclosed by "..." or contains no
  2450.      white space.  Script commands are sequences  of  fields  separated  by
  2451.      white space.
  2452.  
  2453.      For example:
  2454.  
  2455.          SET 1200,N,8,1
  2456.  
  2457.      contains 5 fields.
  2458.  
  2459.      In addition to the 30 user variables provided, there are also built-in
  2460.      system  variables  that  provide  information  about the status of the
  2461.      system.  They are as follows:
  2462.  
  2463.                %BAUD     The current baud rate.
  2464.  
  2465.                %COM      The current COM port number.
  2466.  
  2467.                %DCD      The current  DCD,  Data  Carrier  Detect,  status.
  2468.                          TRUE if present, FALSE otherwise.
  2469.  
  2470.                %FAIL     This  variable is set after a SPAWN,  WAIT or file
  2471.                          transfer command to indicate success  or  failure.
  2472.                          TRUE if failure detected, FALSE if all is well.
  2473.  
  2474.                %MARKED   This variable is set by the execution of the FETCH
  2475.                          command.  It is TRUE if  the  selected  entry  was
  2476.  
  2477.  
  2478.                                    - 42 -
  2479.  
  2480.  
  2481.                          marked for the Circular Dial routines.
  2482.  
  2483.                %NAME     This variable is set after connecting with  a  BBS
  2484.                          via the DDIAL command (or a manual directory dial)
  2485.                          to the name of the BBS.
  2486.  
  2487.                %TIME     The current time.
  2488.  
  2489.                %DATE     The current date.
  2490.  
  2491.                %NUM      In Dial Scripts and after a  FETCH  command,  this
  2492.                          variable will hold the ready to dial phone number.
  2493.                          For example: "ATDT123-4567".
  2494.  
  2495.                %DELETED  This variable is  set  by  the  FETCH  command  to
  2496.                          reflect  the status of the last entry FETCHed from
  2497.                          the phone directory.
  2498.  
  2499.                %CITY     In Dial Scripts and after a  FETCH  command,  this
  2500.                          variable will hold the PCP  City  field  from  the
  2501.                          selected entry in the phone directory.
  2502.  
  2503.      You  will  notice  the  words  TRUE  and FALSE in some of the variable
  2504.      explanations above,  these are boolean constants that are used to test
  2505.      the  %DCD,  %BUSY,  %MARKED,  %DELETED,  and %FAIL state with the CASE
  2506.      statement.
  2507.  
  2508.  
  2509.      Line Labels
  2510.      -----------
  2511.      A script may have line labels.  These labels are used  with  the  GOTO
  2512.      command  to  alter  the flow of execution of the script.  A line label
  2513.      must be coded with a ':' character in the first position,  followed by
  2514.      a name of up to 20 characters.  For example:
  2515.  
  2516.                      :LOOP
  2517.                         .
  2518.                         .  other script commands go here
  2519.                         .
  2520.                      GOTO LOOP
  2521.  
  2522.      To exit such a loop, the script writer must use the CASE statement and
  2523.      test for the proper exit condition.  Then a transfer of control out of
  2524.      the loop can be executed.
  2525.  
  2526.  
  2527.      Script Command Summary
  2528.      ----------------------
  2529.      ; ............ A line that begins with a semi-colon is ignored by GT.
  2530.      ADD .......... Adds two integers.
  2531.      ALARM ........ Causes an alarm-like sound, until a key is pressed.
  2532.      ASCII XMIT ... Transmit a file using ASCII transmit protocol.
  2533.      AUTOBAUD ..... Send a whacking carriage return to the host.
  2534.      AWAIT ........ Wait for a specified time.
  2535.  
  2536.  
  2537.                                    - 43 -
  2538.  
  2539.  
  2540.      BATCH-YMDM ... File transfer via the Ymodem Batch protocol.
  2541.      BEEP ......... Make a short beep on the system speaker.
  2542.      BREAK ........ Send a "Space Break" to the host.
  2543.      CALL ......... Invoke another script, like subroutines, and return.
  2544.      CAPTURE ...... Toggle capture mode ON/OFF.
  2545.      CASE ......... Test the value of a variable.  Or existence of a file.
  2546.      CD ........... Change disk directories.
  2547.      CHAIN ........ Invoke another script, like subroutines, but NO return.
  2548.      CLEAR ........ Clear the screen.
  2549.      CONCAT ....... Concatenate several strings into a single result.
  2550.      COPY ......... Copy part of one string to another.
  2551.      CURSOR ....... Control whether the screen cursor is visible or not.
  2552.      CYCLE ........ Repeat execution of the current script.
  2553.      DDIAL ........ Dial a host from the phone directory.
  2554.      DELAY ........ Add a delay to each command when ECHO is on.
  2555.      DIAL ......... Dial the specified phone number.
  2556.      DIALER ....... To dial the selected entry in a Dial Script.
  2557.      DIV .......... Divides two integers.
  2558.      drive change . Change the default disk drive.
  2559.      DUPLEX ....... Toggle duplex between FULL/HALF.
  2560.      ECHO ......... Echo script commands to the screen.
  2561.      EMULATE ...... Set ANSI terminal emulation.
  2562.      END .......... Groups commands with a DDIAL or DIAL command.
  2563.      ESAC ......... Terminates a CASE command.
  2564.      EXCH ......... Change phone directories or keyboard macro files.
  2565.      EXIT ......... Used to exit the program.
  2566.      FETCH ........ Fetch a specific entry from the phone directory.
  2567.      FLUSH ........ Throw away the contents of the serial buffers.
  2568.      FUNCTION ..... Send a macro key.
  2569.      GETLN ........ Read a line from serial port and store in a variable.
  2570.      GOTO ......... Go To a line label in the script.
  2571.      GOTOXY ....... Position cursor to the x,y screen coordinates.
  2572.      HANG-UP ...... Hang up the modem.
  2573.      HOST ......... Enter host mode.
  2574.      LEN .......... Return the length of a string.
  2575.      LOG .......... Make an entry in the log file.
  2576.      LOWER ........ Convert a string to lowercase.
  2577.      MEGALINK ..... File transfer via the MegaLink protocol.
  2578.      MKWIN ........ Make a video window with a label.
  2579.      MUL .......... Multiplies two integers.
  2580.      NAME ......... Used with DIAL command to name the host.
  2581.      ONLINE ....... Allows user to temporarily leave the script.
  2582.      PAD .......... Pads string, either right or left justified.
  2583.      POS .......... Find occurance of one string within another.
  2584.      PRINT ........ Toggles the printer ON/OFF.
  2585.      protocol ..... You may use any external protocol in the Alt-I config.
  2586.      QUIET ........ Toggles the beeper ON/OFF.
  2587.      QUIT ......... Exit from script, but remain in GT.
  2588.      READLN ....... Reads input from keyboard into a variable.
  2589.      RECV ......... Receive a file via Xmodem protocol.
  2590.      RIGHT ........ Copy the rightmost 'n' chars from string to string.
  2591.      RMWIN ........ Remove a video window.
  2592.      SCREEN ....... Toggle screen output ON/OFF while WAIT is active.
  2593.      SEALINK ...... File transfer via the SEAlink protocol.
  2594.  
  2595.  
  2596.                                    - 44 -
  2597.  
  2598.  
  2599.      SEND ......... Send a string to the host.
  2600.      SENDLN ....... Send a string to the host, followed by carriage return.
  2601.      SET .......... Used with DIAL command to manually set comm parameters.
  2602.      SET ONLINE ... Used in Dial Scripts to return control to GT.
  2603.      SETCOLOR ..... Set screen colors, both foreground and background.
  2604.      SHELL ........ Execute a program or DOS command.
  2605.      SINGLE STEP .. Single step execution of scripts.  For debugging.
  2606.      SPAWN ........ Invokes external program, without extra COMMAND.COM.
  2607.      SPLIT ........ Set split screen mode.
  2608.      STR .......... Convert an integer to a string.
  2609.      SUB .......... Subtracts two integers.
  2610.      SWAP ......... Swap the positions of the BackSpace and Del keys.
  2611.      TELINK ....... File transfer via the Telink protocol.
  2612.      1KTELINK ..... File transfer via the 1k Telink protocol.
  2613.      TRIM ......... Remove leading and trailing blanks from string.
  2614.      TWAIT ........ Timed wait in milliseconds, max wait is 32 seconds.
  2615.      TDIFF ........ Calculates the difference between two times.
  2616.      UPPER ........ Convert a string to uppercase.
  2617.      VAL .......... Convert a string to an integer.
  2618.      Vn = ......... Assign a value to a variable.
  2619.      WAIT ......... Wait for some string to be received from host.
  2620.      WHEN ......... Trap a string sent from host, during a WAIT & respond.
  2621.      WRITE ........ Write a string to the screen.
  2622.      WRITELN ...... Write a string to the screen, followed by a CR.
  2623.      XMIT ......... Transmit a file via Xmodem protocols.
  2624.      YMODEM ....... File transfer via the Ymodem protocol.
  2625.      YMODEM-G ..... File transfer via the Ymodem-G protocol.
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.  
  2648.  
  2649.  
  2650.  
  2651.  
  2652.  
  2653.  
  2654.  
  2655.                                    - 45 -
  2656.  
  2657.  
  2658.      Script Command Descriptions
  2659.      ---------------------------
  2660.  
  2661.      Command   Description and Example
  2662.      -------   -----------------------
  2663.      1KTELINK  Transfer  a  batch  of  files  using the 1k Telink protocol.
  2664.                Works the same as TELINK,  described below,  but uses the 1k
  2665.                packet size for increased efficiency.
  2666.  
  2667.      ADD       Adds  two  integers  and  stores the result in the requested
  2668.                variable.
  2669.  
  2670.                Example:
  2671.  
  2672.                    V6 ADD 3 7
  2673.                    WRITELN %6
  2674.  
  2675.                This would print 000010 on the screen.  The integer that  is
  2676.                the sum of 3 and 7.
  2677.  
  2678.      ALARM     Causes  a  continuous  ringing  sound to be made until a key
  2679.                stroke is made by the operator.
  2680.  
  2681.                Examples:
  2682.  
  2683.                    ALARM
  2684.                        Alarm is continuous until a key is pressed.
  2685.  
  2686.                    ALARM 5
  2687.                        Alarm continues for the indicated number of seconds,
  2688.                        5 in this example, or until a key is pressed.
  2689.  
  2690.      ASCII XMIT
  2691.                Transmit a file using  the  ASCII  protocol.  Refer  to  the
  2692.                Alt÷A  command  above under the explanation of command keys.
  2693.                The  same  routine  that  executes  the  Alt-A  command  key
  2694.                performs the ASCII XMIT.
  2695.  
  2696.                Example:
  2697.  
  2698.                    ASCII XMIT filename
  2699.                        The filename given is transmitted.  No wildcards may
  2700.                        be used.  Only 1 file at a time may be transmitted.
  2701.  
  2702.      AUTOBAUD  Used  after  the DIAL or DDIAL command to set the hosts baud
  2703.                rate to the caller's.  The  AUTOBAUD  command  can  use  the
  2704.                carriage return or the blank to set the rate.  Usually,  the
  2705.                carriage return is used and it is the default,  however some
  2706.                systems require the blank.
  2707.  
  2708.                Examples:
  2709.  
  2710.                    AUTOBAUD
  2711.                        For carriage return use.
  2712.  
  2713.  
  2714.                                    - 46 -
  2715.  
  2716.  
  2717.  
  2718.                    AUTOBAUD BLANK
  2719.                        For blank use.
  2720.  
  2721.      AWAIT     Used  to  delay execution of the script until the designated
  2722.                time.  GT uses 24:00:00 convention for  midnight.  The  hour
  2723.                field does not roll over until 1 A.M.  Therefore there is no
  2724.                zero  hour,  it  jumps from 24 to 1.  For example:  24:30:00
  2725.                would be 12:30 in the morning.
  2726.  
  2727.                Examples:
  2728.  
  2729.                    AWAIT hh:mm:ss
  2730.  
  2731.                    AWAIT 9:45:00
  2732.  
  2733.                The time is formatted hours, minutes and seconds, all fields
  2734.                must be entered.  Note:  midnight is 24:00:00, the hour does
  2735.                not role over until 1 AM.
  2736.  
  2737.      BATCH-YMDM
  2738.                Transfer a batch of files via the Ymodem Batch protocol.
  2739.  
  2740.                Examples:
  2741.  
  2742.                    BATCH-YMDM RECV *
  2743.                        The filenames are supplied by the host.
  2744.  
  2745.                    BATCH-YMDM XMIT filename
  2746.                        The   filename   listed  is  transmitted.   Wildcard
  2747.                        characters may be used to send a batch of files.
  2748.  
  2749.      BEEP      Causes the speaker to emit a beep.
  2750.  
  2751.                Example:
  2752.  
  2753.                    BEEP
  2754.  
  2755.      BREAK     Used to send a Space Break to the host.  Some hosts will use
  2756.                this to wake-up and logon the user,  mostly UNIX systems and
  2757.                other mini-computers.
  2758.  
  2759.                Example:
  2760.  
  2761.                    BREAK
  2762.  
  2763.      CALL      Causes  a  branch in the flow of execution to the scriptname
  2764.                specified and automatic return to the  calling  script  when
  2765.                finished.  Upon  return to the calling script,  execution is
  2766.                started at the next statement following the CALL statement.
  2767.  
  2768.                Example:
  2769.  
  2770.                    CALL scriptname
  2771.  
  2772.  
  2773.                                    - 47 -
  2774.  
  2775.  
  2776.  
  2777.      CAPTURE   Used to turn-on Capture Mode from  within  a  script.  There
  2778.                are two forms:  "CAPTURE" and "CAPTURE filename".  The first
  2779.                form is used  to  begin  capturing  data,  the  second  form
  2780.                terminates  Capture  Mode  and names the file to receive the
  2781.                captured data.
  2782.  
  2783.                Example:
  2784.  
  2785.                    CAPTURE               { Begin capturing here }
  2786.                        .
  2787.                        .
  2788.                        .
  2789.                    CAPTURE filename      { Finish capturing here }
  2790.  
  2791.      CASE & ESAC
  2792.                Those of you familiar with UNIX should recognize the use  of
  2793.                ESAC,  case spelled backward.  For the others,  ESAC is used
  2794.                to mark the end of the CASE statement.  The  CASE  statement
  2795.                is  used to test for the truth or falsity of some condition,
  2796.                for example it could  be  used  to  implement  a  menu.  The
  2797.                syntax is:
  2798.  
  2799.                               CASE target_value OF
  2800.                                  op1 test_value1
  2801.                                     statement-1
  2802.                                     statement-2
  2803.                                        .
  2804.                                        .
  2805.                                        .
  2806.                                  op2 test_value2
  2807.                                     statement-1a
  2808.                                     statement-2a
  2809.                                        .
  2810.                                        .
  2811.                                        .
  2812.                               ESAC
  2813.  
  2814.                Where  there  may be any number of "op" tests and any number
  2815.                of statements between "op" tests.  The CASE  statement  will
  2816.                perform  the  following  tests  until it reaches the 1st one
  2817.                that is TRUE, (target_value op test_value), when a TRUE test
  2818.                is found,  then the statements associated with that test are
  2819.                executed.  ONLY  one set of statements is selected,  as soon
  2820.                as they have been completed the remainder are skipped, until
  2821.                the ESAC  is  encountered.  Execution  continues  after  the
  2822.                ESAC.  If  no  test evaluates to TRUE,  then all are skipped
  2823.                and execution begins after the  ESAC.  Possible  "op"  codes
  2824.                are:
  2825.  
  2826.                    =    Test for equality.
  2827.  
  2828.                    >    Test if target_value greater than test_value.
  2829.  
  2830.  
  2831.  
  2832.                                    - 48 -
  2833.  
  2834.  
  2835.                    <    Test if target_value less than test_value.
  2836.  
  2837.                    >=   Test   if   target_value   greater  than  or  equal
  2838.                         test_value.
  2839.  
  2840.                    <=   Test if target_value less than or equal test_value.
  2841.  
  2842.                    ~    Test if the  test_value  is  contained  within  the
  2843.                         target_value.
  2844.  
  2845.                    ?    If  no  other  test  prior  to this evaluated to be
  2846.                         TRUE,  then this will be TRUE.  Usually placed just
  2847.                         before the ESAC.  There is no need for a test_value
  2848.                         with  this  "op"  code.  This is a default operator
  2849.                         and is equivalent to  the  ELSE  in  Pascal's  CASE
  2850.                         statement.
  2851.  
  2852.                    EXIST and !EXIST
  2853.                    ----------------
  2854.                         These  two  operators  are  used  to  test  for the
  2855.                         existence of a  file.  The  "target_value"  of  the
  2856.                         CASE  statement  is  the  name  of a file and EXIST
  2857.                         evaluates "true" if that file exists,  while !EXIST
  2858.                         evaluates  "true" if that file does not exist.  See
  2859.                         example.
  2860.  
  2861.                    Boolean values
  2862.                    --------------
  2863.                         You  can  treat  the  "target_value"  of   a   CASE
  2864.                         statement  as if it was a boolen value.  A value of
  2865.                         zero is considered "false" and non-zero is  "true".
  2866.                         Further,  the "op" code field may contain the words
  2867.                         TRUE or FALSE, so that a boolean test is performed.
  2868.                         For example:
  2869.  
  2870.                             CASE %DCD OF
  2871.                                TRUE
  2872.                                   writeln "Carrier is present"
  2873.                                FALSE
  2874.                                   writeln "Carrier is not present"
  2875.                             ESAC
  2876.  
  2877.                         In this case,  if the variable %DCD was  TRUE  then
  2878.                         the first case would execute,  if it was FALSE then
  2879.                         the second would execute.
  2880.  
  2881.                For example:
  2882.  
  2883.                    GETLN V2
  2884.                    CASE %2 OF
  2885.                       ~ BUSY
  2886.                            WRITELN "BUSY found in target!"
  2887.                       ~ CONNECT
  2888.                            WRITELN "CONNECT found in target!"
  2889.  
  2890.  
  2891.                                    - 49 -
  2892.  
  2893.  
  2894.                       ?
  2895.                            WRITELN "Neither found in the target!"
  2896.                    ESAC
  2897.  
  2898.                In this example,  the V2 variable is read  from  the  serial
  2899.                port,  then  tested to see whether it contains the word BUSY
  2900.                or the word  CONNECT.  The  match  is  not  exact,  but  the
  2901.                test_value must be wholly contained somewhere in the target.
  2902.  
  2903.                    CLEAR
  2904.                    WRITELN
  2905.                    WRITELN "Communications Menu"
  2906.                    WRITELN "-------------------"
  2907.                    WRITELN "1.  Call the PC Interconnection BBS"
  2908.                    WRITELN "2.  Call the Fido's Partner BBS"
  2909.                    WRITELN "3.  Call the Dow-Jones Retrieval Service"
  2910.                    WRITELN "4.  Call the Compuserve BBS"
  2911.                    WRITELN "5.  Exit to DOS"
  2912.                    WRITELN
  2913.                    WRITE   "Enter your choice. "
  2914.                    READLN V1
  2915.                    CASE %1 OF
  2916.                       = 1
  2917.                          CHAIN PCINSCRP
  2918.                       = 2
  2919.                          CHAIN FIDOSCRP
  2920.                       = 3
  2921.                          CHAIN DOWJSCRP
  2922.                       = 4
  2923.                          CHAIN COMPSCRP
  2924.                       = 5
  2925.                          WRITELN "Goodbye, and thanks for the call."
  2926.                          TWAIT 3000
  2927.                          EXIT
  2928.                       ?
  2929.                          WRITELN
  2930.                          BEEP
  2931.                          BEEP
  2932.                          WRITELN "Your only choices are 1 through 5."
  2933.                          TWAIT 10000
  2934.                          CYCLE
  2935.                    ESAC
  2936.  
  2937.                In this next example, the use of EXIST will be demonstrated:
  2938.  
  2939.                    V2 = "foo.bar"
  2940.                    CASE %2 OF
  2941.                       EXIST
  2942.                          XMIT %2
  2943.                       ?
  2944.                          WRITE "Skipping " %2 ", cannot locate file."
  2945.                    ESAC
  2946.  
  2947.  
  2948.  
  2949.  
  2950.                                    - 50 -
  2951.  
  2952.  
  2953.                Notice how all fields are entered with "white space" between
  2954.                them.  This  is  required,  as  "=5" is wrong,  and "= 5" is
  2955.                correct.
  2956.  
  2957.  
  2958.      CD        Change directories.
  2959.  
  2960.                Example:
  2961.  
  2962.                    CD directory
  2963.  
  2964.                Works like the DOS equivalent, except that it has no display
  2965.                function.
  2966.  
  2967.      CHAIN     Causes a branch in the flow of execution of  the  script  to
  2968.                the  scriptname  designated.  No  automatic  return  to  the
  2969.                invoking script is made.
  2970.  
  2971.                Example:
  2972.  
  2973.                    CHAIN scriptname
  2974.  
  2975.      CLEAR     Used to clear the screen and place the cursor  in  the  home
  2976.                position.
  2977.  
  2978.                Example:
  2979.  
  2980.                    CLEAR
  2981.  
  2982.      CONCAT    Used to concatenate several strings into a single variable.
  2983.  
  2984.                Example:
  2985.  
  2986.                    V1 CONCAT "xyz" "qed" "45678"
  2987.                    WRITELN %1
  2988.  
  2989.                This  would  produce the string "xyzqed45678" on the console
  2990.                display.
  2991.  
  2992.      COPY      Copies  a  sub-string  from the input argument and saves the
  2993.                result in the indicated variable.
  2994.  
  2995.                Example:
  2996.  
  2997.                    V4 COPY "abcdxxxefgh" 5 3
  2998.                    WRITELN %4
  2999.  
  3000.                This command extracts the string starting  the  5th  postion
  3001.                with  a  length  of 3 characters.  Therefore the information
  3002.                written to the screen would be the string "xxx".
  3003.  
  3004.                The script language contains no LEFT command, since the COPY
  3005.                can be used to do this.  For example,  to  obtain  the  left
  3006.                most 3 characters from a string one would do the following:
  3007.  
  3008.  
  3009.                                    - 51 -
  3010.  
  3011.  
  3012.  
  3013.                    V4 COPY "qwerty" 1 3
  3014.  
  3015.      CURSOR    This command allows the script to control whether the screen
  3016.                cursor is visible or not.
  3017.  
  3018.                Examples:
  3019.  
  3020.                    CURSOR off
  3021.                        Make the cursor invisible.
  3022.  
  3023.                    CURSOR on
  3024.                        Make the cursor visible again.
  3025.  
  3026.      CYCLE     When  found,  it  causes  the  script  processor  to  repeat
  3027.                execution of the script from  the  beginning.  For  example,
  3028.                when you wish to make a script to dial a list of BBS's, then
  3029.                repeat the script when finished it would look like this:
  3030.  
  3031.                    NAME "xxxxxxxxxxxx"
  3032.                    DIAL "123-4567"
  3033.                        AUTOBAUD
  3034.                        ONLINE
  3035.                    END
  3036.                    NAME "yyyyyyyyyyyy"
  3037.                    DIAL "123-4567"
  3038.                        AUTOBAUD
  3039.                        ONLINE
  3040.                    END
  3041.                        .
  3042.                        .  etc., etc...
  3043.                        .
  3044.                    CYCLE 5 TIMES
  3045.  
  3046.                The  CYCLE  command  in  the  example  above would cause the
  3047.                script to  repeat  5  times.  If  the  cycle  count  is  not
  3048.                specified,  then  10 times is the default.  Note:  it is not
  3049.                good practice to put script  commands  that  toggle  between
  3050.                on/off states in a cycled script, unless you cycle them back
  3051.                to  the  original  state before the CYCLE command is issued.
  3052.                Otherwise the command will cycle on/off  from  execution  to
  3053.                execution.  An  example  of  a  toggle  command is DUPLEX or
  3054.                QUIET,  you should put them into initialization scripts  and
  3055.                NOT  in  a script that is CYCLEed.  The CYCLE command can be
  3056.                manually terminated from the keyboard by pressing Ctrl-K.
  3057.  
  3058.                For example:
  3059.  
  3060.                    Script-a
  3061.                    --------
  3062.                    QUIET                    Toggle beeps off.
  3063.                    ECHO                     Toggle command echoing on.
  3064.                    AWAIT 1:30:00            Wait for 1:30 am.
  3065.                    CHAIN script-b           Execute script-b.
  3066.  
  3067.  
  3068.                                    - 52 -
  3069.  
  3070.  
  3071.  
  3072.                    Script-b
  3073.                    --------
  3074.                    NAME "xxxxxxxxxx"        Name who we are calling.
  3075.                    DIAL "123-4567"          Dial the modem.
  3076.                        .
  3077.                        .                    etc., etc...
  3078.                        .
  3079.                    CYCLE 5 TIMES            Execute script-b 5 times.
  3080.  
  3081.      drive change
  3082.                Change default disk drive.  Works like the DOS equivalent.
  3083.  
  3084.                Example:
  3085.  
  3086.                    C:
  3087.  
  3088.      DELAY     This  command  causes  a  delay whenever a line of script is
  3089.                echoed to the screen under the control of the ECHO  command.
  3090.                The delay is measured in milliseonds.
  3091.  
  3092.                Example:
  3093.  
  3094.                    DELAY 100
  3095.                        Would cause a 100 millisecond delay each time a line
  3096.                        is  echoed  to  the screen.  See the ECHO command to
  3097.                        turn this feature on.
  3098.  
  3099.  
  3100.  
  3101.      DIAL      Used to dial the modem.
  3102.  
  3103.                Examples:
  3104.  
  3105.                    DIAL phone# WITH REDIAL
  3106.  
  3107.                    DDIAL name WITH REDIAL
  3108.  
  3109.                The phrase WITH REDIAL is optional.
  3110.  
  3111.                In the second form, DDIAL, the "name" is found in the user's
  3112.                dialing directory and the  parameters  for  baud  rate,  and
  3113.                phone number are set automatically.  If the "name" cannot be
  3114.                found  in  the  directory,   then  the  script  will  resume
  3115.                execution after the next END statement,  as if the host  was
  3116.                unavailable.  The  "name"  does not have to be complete,  it
  3117.                searches for the  first  BBS  name  in  the  directory  that
  3118.                contains "name" within it.  Upper and lower case letters are
  3119.                treated the same.
  3120.  
  3121.                The  commands,  following the DIAL or DDIAL command,  may be
  3122.                grouped together to form the commands required to  access  a
  3123.                particular host.  The END command is used to mark the end of
  3124.                such a group.  If a connection cannot be made with the host,
  3125.  
  3126.  
  3127.                                    - 53 -
  3128.  
  3129.  
  3130.                then  the commands between the DIAL and the END are skipped.
  3131.                If no END is found,  the rest of the commands in the  script
  3132.                are  skipped.  Please  refer to the sample script that comes
  3133.                with the documentation.
  3134.  
  3135.      DIALER    This command is used to dial the selected entry from within
  3136.                a Dial Script.  See the example above in the section describing the
  3137.                phone directory.  This command is extremely simple and easy
  3138.                to use.  It has no parameters and no options.  For example:
  3139.  
  3140.                    DIALER
  3141.  
  3142.      DUPLEX    Toggle between full and half duplex.  The starting condition
  3143.                is FULL duplex.  You may also specify the state you wish  by
  3144.                using the words ON or OFF.  For example:
  3145.  
  3146.                    DUPLEX
  3147.                        Toggle duplex to the opposite state.
  3148.  
  3149.                    DUPLEX ON
  3150.                        Turns half duplex on.
  3151.  
  3152.                    DUPLEX OFF
  3153.                        Turns half duplex off.
  3154.  
  3155.      ECHO      Causes script commands to be displayed on the screen as they
  3156.                are executed.  Useful for debugging new scripts.
  3157.  
  3158.      EMULATE   Starts or stops ANSI standard terminal emulation.
  3159.  
  3160.                Examples:
  3161.  
  3162.                    EMULATE ON
  3163.                        Begins VT-100 emulation.
  3164.  
  3165.                    EMULATE OFF
  3166.                        Ends all VT emulation.
  3167.  
  3168.                    EMULATE VT52
  3169.                        Begins VT-52 emulation.
  3170.  
  3171.      END       Used with DIAL to group commands for a particular host.
  3172.  
  3173.      EXCH      Causes the program to exchange phone  directories,  keyboard
  3174.                macros,  or  GT  config  files.  So  that  more than 1 phone
  3175.                directory, macro or config file may be used.
  3176.  
  3177.                Examples:
  3178.  
  3179.                    EXCH DIRECTORY filename
  3180.                        The filename is the name of the new phone directory.
  3181.                        Note,  there is one difference  between  the  script
  3182.                        command  and the manual,  Alt-D,  method to do this:
  3183.                        this file must exist or an error  will  occur.  With
  3184.  
  3185.  
  3186.                                    - 54 -
  3187.  
  3188.  
  3189.                        the manual method,  the file will be created,  if it
  3190.                        does not already exist.
  3191.  
  3192.                    EXCH MACROS filename
  3193.                        The filename is the name of the new  keyboard  macro
  3194.                        file.  If  it  can be located,  its contents will be
  3195.                        loaded into the function keys.
  3196.  
  3197.                    EXCH CONFIG filename
  3198.                        The filename is the name of the new config file.  If
  3199.                        it can be located,  its contents  will  replace  the
  3200.                        current GT.CNF values inside GT.
  3201.  
  3202.                The  filename  on the EXCH command must not contain any path
  3203.                information.  The program looks for  all  phone  directories
  3204.                under  the  "Directory PATH" from the configuration file and
  3205.                all macro and config files in the  GT  home  directory.  Use
  3206.                the  Alt-I  command  to set the "Directory PATH" and use the
  3207.                GTPATH environment variable to set the GT home directory.
  3208.  
  3209.      EXIT      Used to exit the program from within a script.
  3210.  
  3211.                Example:
  3212.  
  3213.                    EXIT
  3214.  
  3215.      FETCH     Allows a script to retrieve information from the phone
  3216.                directory, i.e. BBS name, PCP city, baud rate, phone number, etc.
  3217.  
  3218.                Example:
  3219.  
  3220.                    FETCH 3
  3221.  
  3222.                Where '3' means to FETCH the  third  entry  from  the  phone
  3223.                directory.  Any entry number may be specified, from 1 to the
  3224.                maximum  number  of  entries,  999.  If  a value higher than
  3225.                currently available is requested,  then the  variable  %FAIL
  3226.                will  be  set  to  TRUE.  If  a value for a deleted entry is
  3227.                selected,  then the %DELETED variable will be set  to  TRUE.
  3228.                If a value for a entry marked for Circular Dial is selected,
  3229.                then  the  %MARKED  variable will be set to TRUE.  The %NUM,
  3230.                %NAME, %CITY and %BAUD variables are filled
  3231.  
  3232.                Here is a simple script that shows the usage of the FETCH
  3233.                command:
  3234.  
  3235.                    v3 = 0
  3236.                    :loop
  3237.                    v3 add %3 1
  3238.                    v4 str %3
  3239.                    case %4
  3240.                       = 100
  3241.                           quit
  3242.                    esac
  3243.  
  3244.  
  3245.                                    - 55 -
  3246.  
  3247.  
  3248.                    fetch %4
  3249.                    case %fail
  3250.                       TRUE
  3251.                           quit
  3252.                    esac
  3253.                    case %deleted
  3254.                       TRUE
  3255.                           goto loop
  3256.                    esac
  3257.                    writeln %4 = %name
  3258.                    goto loop
  3259.  
  3260.      FLUSH     Flushes  the  contents  of  the serial input buffer.  Useful
  3261.                prior to an ONLINE or before dialing a new host.
  3262.  
  3263.                Example:
  3264.  
  3265.                    FLUSH
  3266.  
  3267.      FUNCTION  Execute one of the macro keys.
  3268.  
  3269.                Examples:
  3270.  
  3271.                    FUNCTION KEY 2
  3272.                        This example would execute the string stored in F2.
  3273.  
  3274.                    FUNCTION KEY ALT 2
  3275.                        Executes the contents of Alt-F2.  You can  also  use
  3276.                        SHIFT and CTRL in addition to ALT.
  3277.  
  3278.                    FUNCTION IMMEDIATE "xyz"
  3279.                        The  IMMEDIATE  form of the FUNCTION command is used
  3280.                        to execute a macro in a literal string which follows
  3281.                        the word IMMEDIATE.  There is a special problem with
  3282.                        macro stored in a  script  file,  that  is  the  '%'
  3283.                        character.  The  '%'  character is special,  both to
  3284.                        the macro interpreter and to the script interpreter.
  3285.                        In order to get the script interpreter to pass a '%'
  3286.                        through to the macro interpreter,  one must  code  a
  3287.                        double, like this: '%%'.  For example:
  3288.  
  3289.                                  FUNCTION IMMEDIATE "%%P"
  3290.  
  3291.                        This would cause the macro "%P" to be executed by
  3292.                        the macro interpreter.
  3293.  
  3294.      GETLN     Get  a  line  of  data  from  the  host.  Leading blanks and
  3295.                control  characters  are  stripped  off.  The  command  will
  3296.                timeout   after  40  seconds  waiting  for  the  terminating
  3297.                carriage return or linefeed.
  3298.  
  3299.                Note:  Carriage  returns and linefeeds are stripped from the
  3300.                       beginning  of  the  input.   One  of  these   control
  3301.                       characters  will terminate input ONLY after some data
  3302.  
  3303.  
  3304.                                    - 56 -
  3305.  
  3306.  
  3307.                       has been accumulated.
  3308.  
  3309.                Example:
  3310.  
  3311.                    GETLN V4
  3312.  
  3313.                A variable must  be  specified  to  receive  the  data.  The
  3314.                variables have pre-assigned names: V0 through V29.
  3315.  
  3316.      GOTO      Transfer  flow  of  execution to another location within the
  3317.                current script.  The destination  location  must  be  marked
  3318.                with a 'line label', as described above.
  3319.  
  3320.                Example:
  3321.  
  3322.                    :FOOBAR
  3323.                        .
  3324.                        .
  3325.                        .
  3326.                    GOTO FOOBAR
  3327.  
  3328.      GOTOXY    Used  to  position  the  cursor  at a x,y screen coordinate.
  3329.                This position is always calculated relative to  the  current
  3330.                window, see MKWIN and RMWIN, if any is active.
  3331.  
  3332.                Example:
  3333.  
  3334.                    GOTOXY 10 4
  3335.  
  3336.                        Postion  the cursor to column 10,  row 4.  Column 1,
  3337.                        row 1 is the upper left position of  the  screen  or
  3338.                        window.
  3339.  
  3340.      HANG-UP   Used to hang-up the modem.
  3341.  
  3342.      HOST      Used  to  enter  host  mode  automatically  from  a  script.
  3343.                Nothing else should be in  the  script  following  the  HOST
  3344.                command.  This  command  should not be contained in a script
  3345.                that is called from another script.
  3346.  
  3347.                Examples:
  3348.  
  3349.                    HOST
  3350.  
  3351.                    HOST MODE
  3352.  
  3353.                The word MODE is optional and is used for  documentation  of
  3354.                the script only.
  3355.  
  3356.      LEN       Measures  the  length  of  a string and stores the result as
  3357.                indicated.
  3358.  
  3359.                Example:
  3360.  
  3361.  
  3362.  
  3363.                                    - 57 -
  3364.  
  3365.  
  3366.                    V6 LEN "1234567890"
  3367.                    WRITELN %6
  3368.  
  3369.                This would print 000010 on the screen, because the string is
  3370.                10 characters in length.
  3371.  
  3372.      LOG       Make an entry in the log file.
  3373.  
  3374.                Example:
  3375.  
  3376.                    LOG "This is an entry in the log file, or whatever!"
  3377.  
  3378.      LOWER     Convert a string to  lowercase  and  store  in  the  request
  3379.                variable.
  3380.  
  3381.                Example:
  3382.  
  3383.                    V4 LOWER "ABCD"
  3384.                    WRITELN %4
  3385.  
  3386.                This would print the string "abcd" on the screen.
  3387.  
  3388.      MEGALINK  Transfer a batch of files using the MegaLink protocol.
  3389.  
  3390.                Examples:
  3391.  
  3392.                    MEGALINK RECV *
  3393.                        The file names are supplied by the host.
  3394.  
  3395.                    MEGALINK XMIT filename
  3396.                        The  filename  listed  is  transmitted  to the host.
  3397.                        Wildcards are allowed, to do a batch transfer.
  3398.  
  3399.      MKWIN     Makes a window on the video screen.  All cursor  positioning
  3400.                and  WRITEs  will  take  place within the window until it is
  3401.                removed (see RMWIN below) or  overlaid  with  another  MKWIN
  3402.                window.
  3403.  
  3404.                Example:
  3405.  
  3406.                    MKWIN x1 y1 x2 y2 "label"
  3407.  
  3408.                        'x1' is the x coordinate of the upper left corner.
  3409.                        'y1' is the y coordinate of the upper left corner.
  3410.                        'x2' is the x coordinate of the lower right corner.
  3411.                        'y2' is the y coordinate of the lower right corner.
  3412.  
  3413.                        "label"
  3414.                            The  text  string  that will be displayed as the
  3415.                            title of the window.
  3416.  
  3417.                     MKWIN 3 10 78 15 "Text input window"
  3418.  
  3419.      MUL       Multiplies two integers and stores the product as requested.
  3420.  
  3421.  
  3422.                                    - 58 -
  3423.  
  3424.  
  3425.  
  3426.                Example:
  3427.  
  3428.                    V3 MUL 2 12
  3429.                    WRITELN %3
  3430.  
  3431.                This produces 000024 on the screen,  which is the product of
  3432.                2 times 12.
  3433.  
  3434.      NAME      Used to name the host that the user is calling.  Shows up on
  3435.                the  Redial  window.  Used  with the DIAL command.  Not used
  3436.                with the DDIAL  command,  because  the  BBS  name  from  the
  3437.                dialing directory is used.
  3438.  
  3439.                Example:
  3440.  
  3441.                    NAME string
  3442.  
  3443.      ONLINE    Used  to  exit,  temporarily,  from  script  to manual mode.
  3444.                Useful when using a script to call a host and then  go  into
  3445.                manual operation once connected.
  3446.  
  3447.                Example:
  3448.  
  3449.                    ONLINE
  3450.  
  3451.         +----------------------------------------------------------------+
  3452.         |                            NOTE                                |
  3453.         |                                                                |
  3454.         |        When you press Alt-X, you exit back to the script       |
  3455.         |        and script execution begins where it left-off.          |
  3456.         |                                                                |
  3457.         +----------------------------------------------------------------+
  3458.  
  3459.  
  3460.      PAD       Pads a string with a pad character,  on the right  or  left,
  3461.                until the specified width is reached, then stores the result
  3462.                as requested.
  3463.  
  3464.                Example:
  3465.  
  3466.                    V12 PAD "foo" 10 " "
  3467.                    WRITELN %12
  3468.  
  3469.                The string "foo       " would be printed on the screen.
  3470.  
  3471.                    V5   PAD  "bar"  -7  "."
  3472.  
  3473.                The  string  "....bar"  would be printed on the screen.  The
  3474.                negative width indicates the  right  justification  and  the
  3475.                indicated pad character is the ".".
  3476.  
  3477.      POS       Finds  the  occurence of one string within another.  Returns
  3478.                the position of the found string or 0 (FALSE) if not found.
  3479.  
  3480.  
  3481.                                    - 59 -
  3482.  
  3483.  
  3484.  
  3485.                Example:
  3486.  
  3487.                    V1 POS "xxx" "abcdxxxefghi"
  3488.                    WRITELN %1
  3489.  
  3490.                This would print 000005 on the screen,  since the "xxx"  was
  3491.                found at the 5th character of the mask string.
  3492.  
  3493.                    V10 POS "xxx" "abcde"
  3494.                    WRITELN %10
  3495.  
  3496.                This  would  print  000000  on  the screen,  since the "xxx"
  3497.                cannot be found within the 2nd string.
  3498.  
  3499.  
  3500.      PRINT     Toggle the printer on and off.  The printer will run as data
  3501.                is received from the host.  Equivalent to Ctrl-PrtSc.
  3502.  
  3503.                Example:
  3504.  
  3505.                    PRINT
  3506.                        Toggle the PRINT on and off.
  3507.  
  3508.                    PRINT ON
  3509.                        Toggle commands may  specify  the  requested  state.
  3510.                        This would turn the printer ON.
  3511.  
  3512.                    PRINT OFF
  3513.                        Turn the printer OFF.
  3514.  
  3515.      QUIET     Toggle  the  beeps on and off.  The starting condition is to
  3516.                have beeps ON.
  3517.  
  3518.                Example:
  3519.  
  3520.                    QUIET
  3521.                        Toggles from existing state to the opposite state.
  3522.  
  3523.                    QUIET ON
  3524.                        Turns off the beeps and other noise.
  3525.  
  3526.                    QUIET OFF
  3527.                        Turns on the noise.
  3528.  
  3529.      READLN    This command is used to read data from the operator into one
  3530.                of the 30 variables.  The variables have pre-assigned names:
  3531.                V0 - V29.  The syntax is:
  3532.  
  3533.                    READLN variable_name
  3534.  
  3535.                For example:
  3536.  
  3537.                    WRITE "Enter desired time to start. (hh:mm:ss): "
  3538.  
  3539.  
  3540.                                    - 60 -
  3541.  
  3542.  
  3543.                    READLN V2
  3544.                    AWAIT %2
  3545.  
  3546.                Notice the %2 in the 3rd line of the example,  the  %  tells
  3547.                the  script  processor to do a variable substitution at this
  3548.                point,  so the value input for variable 2 is  inserted  into
  3549.                the  AWAIT  command.  Thus causing the script to pause until
  3550.                the desired time.
  3551.  
  3552.                Note:  When responding to a READLN the user  must  type  the
  3553.                       response  followed by a carriage return.  If the user
  3554.                       wants to terminate the script at the READLN  command,
  3555.                       enter ^K followed by a carriage return.
  3556.  
  3557.      RECV      Receive a file using the Xmodem protocol.
  3558.  
  3559.                Example:
  3560.  
  3561.                    RECV filename
  3562.                        Receives a single file from the host.
  3563.  
  3564.      RIGHT     Extracts the rightmost part of a string.
  3565.  
  3566.                Example:
  3567.  
  3568.                    V3 RIGHT "....xyz" 3
  3569.                    WRITELN %3
  3570.  
  3571.                This  command  would  print  the string "xyz" on the screen,
  3572.                because the right 3 characters  of  the  source  string  are
  3573.                stored in V3.
  3574.  
  3575.      RMWIN     Remove  window made with prior MKWIN.  All windows made with
  3576.                MKWIN should be removed before final exit from the script.
  3577.  
  3578.      SCREEN    Used to turn-off the screen display, i.e. stop incoming data
  3579.                from appearing during the WAIT command.
  3580.  
  3581.                Examples:
  3582.  
  3583.                    SCREEN OFF
  3584.                        Turns screen off.
  3585.  
  3586.                    SCREEN ON
  3587.                        Turns screen on.
  3588.  
  3589.      SEALINK   Transfers a batch of files using the SEAlink protocol.
  3590.  
  3591.                Examples:
  3592.  
  3593.                    SEALINK RECV *
  3594.                        Receives a group of files sent by the host.
  3595.  
  3596.                    SEALINK XMIT filename
  3597.  
  3598.  
  3599.                                    - 61 -
  3600.  
  3601.  
  3602.                        Transmits the filename given to the  host.  A  batch
  3603.                        of files may be sent by using wildcard characters.
  3604.  
  3605.      SEND      Used to send a string to the host.  The string  may  contain
  3606.                the  '|'  character,  which  will  be  changed to a carriage
  3607.                return.  Up to 10 strings can be sent to the host  with  one
  3608.                command.
  3609.  
  3610.                Example:
  3611.  
  3612.                    SEND string1 string2
  3613.  
  3614.                The two strings would be sent to the host without  any  gaps
  3615.                between them.
  3616.  
  3617.                The strings may be enclosed within "...", if embedded blanks
  3618.                are required.
  3619.  
  3620.      SENDLN    Same as SEND above,  but sends a carriage return at the  end
  3621.                of the transmission.
  3622.  
  3623.                Example:
  3624.  
  3625.                    SENDLN string1 string2
  3626.  
  3627.                Up  to  10 strings can be sent to the host with one command,
  3628.                the carriage return is sent following the last string.
  3629.  
  3630.      SET       Used to set the serial port parameters: COM port, baud rate,
  3631.                parity, data bits and stop bits.
  3632.  
  3633.                Examples:
  3634.  
  3635.                    SET 1200,N,8,1
  3636.                        This would set 1200 baud, no parity, 8 data bits and
  3637.                        one stop bit. Legal baud rate values are: 300, 1200,
  3638.                        2400,  4800,  9600,  and 19200.  Legal parity values
  3639.                        are N=none, E=even and O=odd.  Legal data bits are 7
  3640.                        or 8. Legal stop bits are 1 or 2.
  3641.  
  3642.                    SET COM2 2400 E 7 1
  3643.                        This  SET command would work in a similar fashion to
  3644.                        the first example,  however it would also switch the
  3645.                        COM port to number 2.
  3646.  
  3647.      SET ONLINE
  3648.                Within a Dial Script,  this command is used to terminate the
  3649.                script,  returning control to GT,  and pass back  to  GT  an
  3650.                indication  of  the success or lack therof in establishing a
  3651.                connection.
  3652.  
  3653.                Examples:
  3654.  
  3655.                    SET ONLINE TRUE
  3656.  
  3657.  
  3658.                                    - 62 -
  3659.  
  3660.  
  3661.                        This SET ONLINE command  would  terminate  the  Dial
  3662.                        Script  and  return  an  indicator telling GT that a
  3663.                        successful connection has been established.
  3664.  
  3665.                    SET ONLINE FALSE
  3666.                        This SET ONLINE command  would  terminate  the  Dial
  3667.                        Script  and  return  an  indicator telling GT that a
  3668.                        successful connection could not be established.
  3669.  
  3670.      SETCOLOR  Set  the  screen  colors  to  be used with the next WRITE or
  3671.                WRITELN command.
  3672.  
  3673.                Example:
  3674.  
  3675.                    SETCOLOR 11 0
  3676.                        Set the  foreground  to  11  (Light  Cyan)  and  the
  3677.                        background to 0 (Black).
  3678.  
  3679.                    Dark Colors         Light Colors
  3680.                    -----------         ------------
  3681.                    0 : Black           8  : Dark Gray
  3682.                    1 : Blue            9  : Light Blue
  3683.                    2 : Green           10 : Light Green
  3684.                    3 : Cyan            11 : Light Cyan
  3685.                    4 : Red             12 : Light Red
  3686.                    5 : Magenta         13 : Light Magenta
  3687.                    6 : Brown           14 : Yellow
  3688.                    7 : Light Gray      15 : White
  3689.  
  3690.      SHELL     This  command  allows  you  to  execute  any  program or DOS
  3691.                command, if there is enough memory available.
  3692.  
  3693.                Example:
  3694.  
  3695.                    SHELL "copy file1 file2"
  3696.  
  3697.                This would cause the COPY command to  be  executed  and  the
  3698.                files named to be copied.
  3699.  
  3700.      SINGLE STEP
  3701.                This command allows script processing to be done  1  command
  3702.                at a time.  When in SINGLE STEP mode,  the script will pause
  3703.                after the execution of each line of code and display the '~'
  3704.                character.  Any key may be pressed to resume execution - the
  3705.                '~' will be erased and execution will continue with the next
  3706.                script statement.
  3707.  
  3708.                Example:
  3709.  
  3710.                    SINGLE STEP on
  3711.                        Begin SINGLE STEP mode.
  3712.  
  3713.                    SINGLE STEP off
  3714.                        End SINGLE STEP mode.
  3715.  
  3716.  
  3717.                                    - 63 -
  3718.  
  3719.  
  3720.  
  3721.      SPAWN     Invokes  an  external  program as a child process.  Does not
  3722.                execute a second copy of COMMAND.COM.  Sets the  %FAIL  flag
  3723.                if  the  external program returns an error code on "exit()".
  3724.                The SPAWN command supports arguments that are passed to  the
  3725.                child  process  as  command line paramters,  up to 10 can be
  3726.                specified, arg0 through arg9,  where arg0 is the name of the
  3727.                child process.
  3728.  
  3729.                Example:
  3730.  
  3731.                    SPAWN c:\gt\dsz.exe port %COM speed %BAUD rz
  3732.  
  3733.                This  example would cause the DSZ.EXE program to be executed
  3734.                to receive files.  Upon return from  the  SPAWN,  the  %FAIL
  3735.                variable  will be set according to the success or failure of
  3736.                the transfer.
  3737.  
  3738.                NOTE: the complete and full pathname  *must*  be  used  when
  3739.                      executing  the  SPAWN command.  No search is performed
  3740.                      to locate the requested program.
  3741.  
  3742.      SPLIT     Starts or stops Split-Screen operation.
  3743.  
  3744.                Examples:
  3745.  
  3746.                    SPLIT SCREEN ON
  3747.                        Begins Split-Screen.
  3748.  
  3749.                    SPLIT SCREEN OFF
  3750.                        Ends Split-Screen.
  3751.  
  3752.      STR       Converts an integer argument to a  string  result  with  the
  3753.                requested width.
  3754.  
  3755.                Example:
  3756.  
  3757.                    V5 STR 234 6
  3758.                    WRITELN %5
  3759.  
  3760.                The  above  code  would  write  a  string to the screen that
  3761.                consisted of 3 leading blanks and the numbers 234.  In other
  3762.                words, the string in V5 would be " 234".
  3763.  
  3764.      SUB       Subtracts two integers and stores the result as requested.
  3765.  
  3766.                Example:
  3767.  
  3768.                    V21 SUB 10 3
  3769.                    WRITELN %21
  3770.  
  3771.                This would print 000007 on the screen,  which is the integer
  3772.                that is the result of 10 minus 3.
  3773.  
  3774.  
  3775.  
  3776.                                    - 64 -
  3777.  
  3778.  
  3779.      SWAP      This command swaps the position of the <Backspace> and <Del>
  3780.                keys.  This  is  needed  by  many  people who use the VT-100
  3781.                emulation mode.
  3782.  
  3783.                Examples:
  3784.  
  3785.                    SWAP KEYS ON
  3786.                        This would swap the two keys, <Backspace> and <Del>.
  3787.  
  3788.                    SWAP KEYS OFF
  3789.                        This would reverse a previous swapping of the keys.
  3790.  
  3791.                        Note:  Key swaps made with this command are not made
  3792.                               a permanent part of the .CNF  file.  They  go
  3793.                               back to the default value at the start of the
  3794.                               program.  Use  the  Alt-I command to make the
  3795.                               swap permanent.
  3796.  
  3797.      TDIFF     Calculates  the  difference  between  two  time  values  and
  3798.                reports the result in minutes in integer format.
  3799.  
  3800.                Example:
  3801.  
  3802.                    ;Capture starting time
  3803.                    V1 = %time
  3804.                    V2 = %date
  3805.                    WRITELN "The current date/time is: " %1 " " %2
  3806.                    ONLINE
  3807.                    ;Calculate difference between now and the starting time
  3808.                    V3 TDIFF %time %1
  3809.                    ;Convert answer from integer to string format
  3810.                    V4 STR %3
  3811.                    ;Tell the operator about the time consumed
  3812.                    WRITELN %4 " minutes spent ONLINE on " %name " BBS"
  3813.  
  3814.      TELINK    Transfer a batch of files using the Telink protocol.
  3815.  
  3816.                Examples:
  3817.  
  3818.                    TELINK XMIT *.pas
  3819.                        Transmits all files with the .PAS extension.
  3820.  
  3821.                    TELINK RECV *
  3822.                        Receive a group of files from the host.
  3823.  
  3824.      TRIM      Removes leading and trailing blanks from a string and stores
  3825.                the result as indicated.
  3826.  
  3827.                Example:
  3828.  
  3829.                    V7 TRIM "   qed   "
  3830.                    WRITELN %7
  3831.  
  3832.                The command would strip the spaces and store  "qed"  in  V7.
  3833.  
  3834.  
  3835.                                    - 65 -
  3836.  
  3837.  
  3838.                Then the WRITELN would print the "qed" on the screen.
  3839.  
  3840.      TWAIT     Timed  wait,  in  milliseconds.  The  maximum wait period is
  3841.                32767 milliseconds.
  3842.  
  3843.                Example:
  3844.  
  3845.                    TWAIT number
  3846.                        The "number" is the number of milliseconds to  delay
  3847.                        the execution of the script.
  3848.  
  3849.      UPPER     Convert  a  string  to  uppercase  and  store in the request
  3850.                variable.
  3851.  
  3852.                Example:
  3853.  
  3854.                    V4 UPPER "abcd"
  3855.                    WRITELN %4
  3856.  
  3857.                This would print the string "ABCD" on the screen.
  3858.  
  3859.      Vn =      Variables can be assigned values  in  2  ways,  through  the
  3860.                READLN command above,  or within the script itself, they can
  3861.                be assigned values,  much the same way it is done in FORTRAN
  3862.                and other high-level languages.  The syntax is:
  3863.  
  3864.                    Vn = value
  3865.  
  3866.                For example:
  3867.  
  3868.                    V0 = "the PC Interconnection"
  3869.                    V7 = "555-1234"
  3870.                    V2 = "Johnny Jones"
  3871.  
  3872.                Note:  The  use  of blanks to isolate the "=" from the other
  3873.                       fields, this is REQUIRED.
  3874.  
  3875.      VAL       Converts a string argument to an integer value.
  3876.  
  3877.                Example:
  3878.  
  3879.                     V1 VAL "23"
  3880.                     WRITE %1
  3881.  
  3882.                This would produce 000023 on the screen for the user to see.
  3883.                The string might  have  contained  leading  white-space  and
  3884.                trailing  non-numerics  (the  conversion ends with the first
  3885.                non-numeric.  If no characters are found to be numeric,  the
  3886.                result would be 000000.
  3887.  
  3888.      WAIT      Used  to  make  the  execution  of  the  script  wait  for a
  3889.                particular string to be sent from the host.
  3890.  
  3891.                Examples:
  3892.  
  3893.  
  3894.                                    - 66 -
  3895.  
  3896.  
  3897.  
  3898.                    WAIT FOR string
  3899.  
  3900.                    WAIT n FOR string
  3901.  
  3902.                The string may be in "...", if embedded blanks are required.
  3903.                In the 2nd form, the "n" represents the number of seconds to
  3904.                wait before timing-out the host.  Note,  the  timeout  clock
  3905.                only counts down when no data is being sent by the host.  If
  3906.                the  first  form is used,  the default time-out period is 40
  3907.                seconds.
  3908.  
  3909.                If the WAIT command times out  waiting  for  the  string  to
  3910.                arrive,  the  %FAIL  variable will be set TRUE,  so that the
  3911.                script can test for the failure and take action  based  upon
  3912.                the failure.
  3913.  
  3914.      WHEN      Sets  up  a string to trap out,  while waiting with the WAIT
  3915.                command.  Whenever the indicated string is trapped, then the
  3916.                response shown will be sent to the  host.  This  feature  is
  3917.                mostly  used  to trap the "More" string and send a Y or N to
  3918.                the host.  If required by the host, a carriage return may be
  3919.                inserted in the response string  by  using  a  |  character.
  3920.                Both  the  string  trapped and the response are limited to a
  3921.                maximum of 30 characters each.
  3922.  
  3923.                Example:
  3924.  
  3925.                    WHEN "More" THEN "N"
  3926.  
  3927.                This will keep the WAIT command from getting  stuck  at  the
  3928.                "More"  prompt.  Note:  up  to  6  WHEN  commands  remain in
  3929.                effect.
  3930.  
  3931.                Individual WHEN's may  be  disabled  by  omitting  the  THEN
  3932.                clause.
  3933.  
  3934.                For example:
  3935.  
  3936.                    WHEN "More" THEN "N"       Setup the trap.
  3937.                    WHEN "More"                Turns off the trap.
  3938.  
  3939.      WRITE     Used  to write a string to the screen,  does not send to the
  3940.                host.  Up to ten strings  can  be  written  with  one  WRITE
  3941.                command.  Each string should have white-space surrouding it.
  3942.  
  3943.                Example:
  3944.  
  3945.                    WRITE string1 string2 string3
  3946.                        Would  write the 3 strings to the screen without any
  3947.                        space between them.
  3948.  
  3949.                    WRITE "foo." "bar"
  3950.                        Would write "foo.bar" to  the  screen  (without  the
  3951.  
  3952.  
  3953.                                    - 67 -
  3954.  
  3955.  
  3956.                        "..." of course).
  3957.  
  3958.      WRITELN   Used to write a string to the screen with a carriage return,
  3959.                linefeed  combination at the end of the line,  does not send
  3960.                to the host.
  3961.  
  3962.                Example:
  3963.  
  3964.                    WRITELN string
  3965.  
  3966.                Please note that WRITELN behaves the same way as  the  WRITE
  3967.                above, that it can write up to 10 strings to the screen with
  3968.                one WRITELN command.
  3969.  
  3970.      WXMODEM   Transfer a file using the WXmodem protocol.
  3971.  
  3972.                Examples:
  3973.  
  3974.                    WXMODEM XMIT filename
  3975.                        Transmits a file to the host.
  3976.  
  3977.                    WXMODEM RECV filename
  3978.                        Receives a file from the host.
  3979.  
  3980.      XMIT      Transmit a file using the Xmodem protocol.
  3981.  
  3982.                Example:
  3983.  
  3984.                    XMIT filename
  3985.                        Transmits a file to the host.
  3986.  
  3987.      YMODEM    Transfer a file using the Ymodem protocol.
  3988.  
  3989.                Examples:
  3990.  
  3991.                    YMODEM XMIT filename
  3992.                        Transmits a file to the host.
  3993.  
  3994.                    YMODEM RECV filename
  3995.                        Receives a file from the host.
  3996.  
  3997.      YMODEM-G  Transfer files using the Ymodem-G batch protocol.
  3998.  
  3999.                Examples:
  4000.  
  4001.                    YMODEM-G XMIT foo.*
  4002.                        Transmits a batch of files that have the  same  root
  4003.                        name,  'foo', but various different extensions, i.e.
  4004.                        foo.bat, foo.bar, foo.nut.
  4005.  
  4006.                    YMODEM-G RECV *
  4007.                        Receives a batch of files from the host.
  4008.  
  4009.  
  4010.  
  4011.  
  4012.                                    - 68 -
  4013.  
  4014.  
  4015.                                     Appendix
  4016.                                     --------
  4017.      25th Line Status Indicators
  4018.      ---------------------------
  4019.      CAPTURE: 999   Capture  mode  is  on,  and the number displayed is the
  4020.                     amount of data, in 1000's of characters, in the capture
  4021.                     buffer.
  4022.  
  4023.      Suspend: 999   Capture  mode  is  on,  but  suspended  currently.  The
  4024.                     number  displayed  is  the  amount of data in 1000's of
  4025.                     characters in the capture buffer.
  4026.  
  4027.      BBS Name       If no capture is currently active, the name of the BBS,
  4028.                     you  are  currently   communicating   with,   will   be
  4029.                     displayed.
  4030.  
  4031.      Caller Name    In host mode,  the name of the current caller  to  your
  4032.                     system  will be displayed.  Appended to the caller name
  4033.                     will be the city and state where the caller is located.
  4034.  
  4035.      CONNECT 99:99  Time CONNECTed to a BBS in hours and minutes.
  4036.  
  4037.      OFF LINE       Indicates you are currently not connected to a BBS.
  4038.  
  4039.      CABLE CONNECT  Indicates  that  you  are  currently  using   a   cable
  4040.                     connection to your host system.
  4041.  
  4042.      ^              The Caps Lock is on.
  4043.  
  4044.      #              The Num Lock is on.
  4045.  
  4046.      Q              Beeps are turned off.
  4047.  
  4048.      CD             Carrier  Detected  (is present).  When carrier is lost,
  4049.                     an alarm sounds.
  4050.  
  4051.      PR             The printer is on.
  4052.  
  4053.      VT             VT-100 terminal emulation is enabled.
  4054.  
  4055.      52             VT-52 terminal emulation is enabled.
  4056.  
  4057.      HDX            Half Duplex is true, the default in host mode.
  4058.  
  4059.      Chk            Checksum Xmodem is true, the default is CRC Xmodem.
  4060.  
  4061.      SCR            A script is currently active.  It may be hidden by  the
  4062.                     ONLINE command, but it is there.
  4063.  
  4064.      baud rate      The current baud rate in use:  300,  1200,  2400, 4800,
  4065.                     9600, or 19200.
  4066.  
  4067.      99:99          The current time.
  4068.  
  4069.  
  4070.  
  4071.                                    - 69 -
  4072.  
  4073.  
  4074.      System Files
  4075.      ------------
  4076.      Here is a list and short description of each of the many files
  4077.      provided with the GT POWER system:
  4078.  
  4079.           GT1600.EXE .... Absolute program.  The one to execute.
  4080.           GTO1600.EXE ... The GTerminal Only version of GT.  Called GTO.
  4081.           GT1600.DOC .... This file.  The documentation.
  4082.           TDOOR.EXE ..... This program is used when a function overlays GT.
  4083.                           The /V command line  option  cannot  function  if
  4084.                           this program cannot be located on the disk.
  4085.           DOOR.EXE ...... Same as TDOOR.EXE, but for usage with the Rapid
  4086.                           versions.
  4087.           GTBIMOD.EXE ... Interface program for the BiModem file transfer
  4088.                           protocol executed in the BITX and BIRX batch
  4089.                           file.
  4090.           PCKERMIT.EXE .. The program which performs Kermit file transfers.
  4091.           PCKERMIT.TXT .. Documentation for PCKERMIT.EXE.
  4092.           GTZ.EXE ....... Performs Zmodem file transfers.
  4093.           GTZ.TXT ....... Documentation for DSZ.EXE.
  4094.         * GT.DIR ........ The phone directory, data file.
  4095.         * GT.KEY ........ Macro key definitions, data file.
  4096.         * GT.CNF ........ The configuration, data file.
  4097.           RAMDISK.BAT ... Sample runstream to execute GT from ramdisk.
  4098.         * GT.LOG ........ Log file.  Note:  don't edit the log file with an
  4099.                           editor which places a CPM EOF (Hex 1A) at the end
  4100.                           of a file.  GT is unable to append log entries to
  4101.                           a file which ends with the CPM EOF - a  quirk  of
  4102.                           Turbo PASCAL.
  4103.           GT_UTIL.COM ... Program  to  convert  old  directories  to  newer
  4104.                           format,   produce  printed   listing   of   phone
  4105.                           directory, import text list of BBS's to GT format
  4106.                           directory.  Also, converts some Qmodem formats to
  4107.                           the GT format.
  4108.           GT_UTIL.DOC ... Short doc file for GT_UTIL.
  4109.           PURSUIT.SCR ... Script used to access the PC Pursuit network.
  4110.           PCPMENU.SCR ... Script called by PURSUIT.SCR, used to access PC
  4111.                           Pursuit.
  4112.           SCRIPT.SCR .... A sample script for use with GT.
  4113.           REGISTER.DOC .. Description of the registration plan.
  4114.           GT.WIN ........ Screen file for GT.  Must be present.  Not user
  4115.                           changeable.
  4116.           FORM.DOC ...... A registration form, ready to be filled in and
  4117.                           printed.
  4118.           GTHOST.DOC .... Documentation for host mode.
  4119.           GTDOOR.BAT .... Executed when host mode caller requests "Shell to
  4120.                           DOS".
  4121.           GTDOOR1.BAT ... Sample DOOR batch file.
  4122.           GTDOORS.BBS ... DOOR menu text file.
  4123.           KEYBOARD.MAC .. Keyboard macros to use with ANSI.SYS and the DOS
  4124.                           Door.
  4125.           GTWELCOM.BBS .. Welcome screen for host mode.  }******
  4126.           GTUSER.BBS .... Record of last user's name.    }
  4127.           PROTOCOL.BBS .. Protocol menu text file.       }
  4128.  
  4129.  
  4130.                                    - 70 -
  4131.  
  4132.  
  4133.           PREQUEST.BBS .. Pre-questionnaire text file.   }
  4134.           QUESTION.BBS .. Questionnaire template file.   }
  4135.           GTBULLET.BBS .. Bulletin file for host mode.   }
  4136.           BULLET1.BBS ... Custom bulletin file #1.       } Example files used
  4137.           BULLET2.BBS ... Custom bulletin file #2.       } in GT host mode.
  4138.           GTMENU.BBS .... Main menu file for host mode.  } These are ordinary
  4139.           GTPASSWD.BBS .. Password file for host mode.   } text files and may
  4140.           GTHELP.BBS .... Help file for host mode.       } be changed with an
  4141.           GTDIR.BBS ..... Directory control list.        } ASCII text editor.
  4142.           GTMDIR.BBS .... Message area control list.     }
  4143.           GTDDIR.BBS .... DOOR control list.             }
  4144.           GTSYSID.BBS ... Initial system ID for callers. }
  4145.           WELCOME.BBS ... Message area welcome file.     }
  4146.           MBULLET1.BBS .. Message area bulletin file.    }
  4147.           GTBYE.BBS ..... Goodbye file for host mode.    }******
  4148.           MBAG500.COM ... The netmail bagger program.       } Refer to
  4149.           MDRIV048.COM .. The netmail driver program.       } netmail
  4150.           MDRIV048.000 .. An overlay file for MDRIVER.      } documentation
  4151.           MDRIV048.001 .. An overlay file for MDRIVER.      } for further
  4152.           MDRIV048.002 .. An overlay file for MDRIVER.      } explanation
  4153.           MDRIV048.003 .. An overlay file for MDRIVER.      }
  4154.           MDIST500.COM .. The netmail distribution program. }
  4155.           NETMAIL.DOC ... The netmail documentation file.
  4156.           ADDENDUM.NET .. Addendum file for netmail.  Many of the newer
  4157.                           features are documented in this file.
  4158.           SYSOP.BBS ..... File containing most of the short text menus
  4159.                           and prompts used in the host mode.  May be user
  4160.                           customized.
  4161.  
  4162.         * The  files  marked  with an "*" above  are  created   automatically
  4163.           whenever GT cannot locate them.
  4164.  
  4165.  
  4166.  
  4167.  
  4168.  
  4169.  
  4170.  
  4171.  
  4172.  
  4173.  
  4174.  
  4175.  
  4176.  
  4177.  
  4178.  
  4179.  
  4180.  
  4181.  
  4182.  
  4183.  
  4184.  
  4185.  
  4186.  
  4187.  
  4188.  
  4189.                                    - 71 -
  4190.  
  4191.  
  4192.      Configuration File Layout
  4193.      ------------------------
  4194.      In  position 1-3 of each record in the configuration file is a code to
  4195.      identify a parameter.  After the  "=",  the  value  of  the  parameter
  4196.      appears.
  4197.  
  4198.      CM= COM port number, 1,2,3 or 4.
  4199.      ST= Number of Stopbits.
  4200.      DA= Number of Databits.
  4201.      PA= Parity. 0=None,1=Even,2=Odd
  4202.      SR= Stripping option.  Strip parity bit from serial port input.
  4203.      BA= Default Baud Rate. 300,1200,2400,4800,9600 or 19200.
  4204.      MB= Maximum Baud Rate.  Restricts values found in Phone Directory.
  4205.      CS= Honor CTS from modem option.
  4206.      S2= String to set modem to 300 baud.            }******
  4207.      S4= String to set modem to 1200 baud.           }
  4208.      S5= String to set modem to 2400 baud.           }
  4209.      S6= String to set modem to 4800 baud.           }
  4210.      S7= String to set modem to 9600 baud.           }
  4211.      S8= String to set modem to 19200 baud.          } For non-Hayes
  4212.      P0= String to set modem to 7 bits, no parity.   } modems only.  See
  4213.      P1= String to set modem to 7 bits, even parity. } table on page 56.
  4214.      P2= String to set modem to 7 bits, odd parity.  }
  4215.      P3= String to set modem to 8 bits, no parity.   }
  4216.      P4= String to set modem to 8 bits, even parity. }
  4217.      P5= String to set modem to 8 bits, odd parity.  }
  4218.      P6= String to set modem to 7 bits, mark parity. }
  4219.      P7= String to set modem to 8 bits, mark parity. }******
  4220.      PR= Dialing Pre String.
  4221.      PO= Dialing Post String,  use  the  |  character  where  a  Return  is
  4222.             required.
  4223.      HU= The modem hang-up string.
  4224.      PF= Phone number prefix/suffix.  Associated with the  -  character.
  4225.      P+= Phone number prefix/suffix.  Associated with the  +  character.
  4226.      P*= Phone number prefix/suffix.  Associated with the  *  character.
  4227.      P!= Phone number prefix/suffix.  Associated with the  !  character.
  4228.      MI= Modem  initialization  string.  Use the | character where a Return
  4229.             is needed.
  4230.      HO= Host mode, modem initialization string.
  4231.      AS= Answer string.  When issued, this string should cause the modem to
  4232.             answer an incoming call.
  4233.      SY= Modem command string to turn the speaker ON.
  4234.      SN= Modem command string to turn the speaker OFF.
  4235.      RT= After carrier timeout has  occurred,  this  is  the  time  between
  4236.             redial, in seconds.
  4237.      FC= Forced Carrier.  Some modems force carrier even when a call is not
  4238.             in progress, if this is the case, set this parameter to TRUE.
  4239.      CT= Timeout time for carrier to appear, in seconds.
  4240.      DP= Directory PATH.  This variable tells the program where to look for
  4241.             the  phone  directory.  This  parameter  is provided mainly for
  4242.             people who wish to put the dialing directory on a RAM-disk.
  4243.      TP= Download PATH.  All files received by GT are placed,  by  default,
  4244.             in this directory.  User may override, by typing full pathnames
  4245.             when entering filenames.  Effects host mode operation also!
  4246.  
  4247.  
  4248.                                    - 72 -
  4249.  
  4250.  
  4251.      UP= Upload PATH.  Does not apply to host mode operation.
  4252.      SP= Script PATH.  Scripts are stored in this directory.
  4253.      CP= Capture PATH.  Capture saves are done to this directory.
  4254.      MP= Message  base  PATH.  Controls where GT will place the *.CTL files
  4255.             and the GTMSGS sub-directory.
  4256.      XO= The decimal value of the XON character.  Used to control data flow
  4257.             Starts data flow after XOFF has been issued.
  4258.      XF= The  decimal  value  of  the XOFF character.  Used to control data
  4259.             flow Stops data flow when  issued.  Helps  insure  that  buffer
  4260.             overflow does not occur.
  4261.      VT= If TRUE,  turns on VT100 emulation,  using ANSI escape  codes.  If
  4262.             VT100  emulation  is requested,  music will not be played,  and
  4263.             will show on the screen as text.  This  happens  because  of  a
  4264.             conflict  between  the  full  ANSI  definition  and the musical
  4265.             notes.  This does not  pose  a  problem  for  most  BBS  users,
  4266.             because  they  do not need the full ANSI emulation.  BBS's that
  4267.             send music and graphics use IBM ANSI  graphics,  which  can  be
  4268.             processed without setting VT=TRUE.  For BBS use, this parameter
  4269.             should  be  set  FALSE,  and  the  IBM  ANSI  graphics  will be
  4270.             processed.
  4271.      WN= Suppress window noise.  Do you want video game whistling windows?
  4272.      AW= Auto line wrap mode.  If  FALSE,  characters  received  while  the
  4273.             cursor  is in column 80 of the screen will not wrap to the next
  4274.             line.
  4275.      LF= Auto  Linefeed  mode.   If  TRUE,   then  a   linefeed   will   be
  4276.             automatically supplied whenever a carriage return is received.
  4277.      FG= The  default foreground color number.  Any one of the 16 values in
  4278.             the table below.
  4279.      BG= The default background color number.  Any one of the DARK  shades,
  4280.             0-7, from the table below.
  4281.      CC= The comment character used with the macro keys.
  4282.      MX= Number  of  Xmodem  buffers  to  allocate.  4  - 255 are the legal
  4283.             values.  A smaller number should be used on systems  with  only
  4284.             128k,  larger  values  can be used if more memory is available.
  4285.             Each buffer takes 128 bytes.
  4286.      DM= DMA  mode.  Some  computers have no DMA chip,  some have defective
  4287.             DMA chips.  If you have one of these computer,  you will obtain
  4288.             better results with file transfers, if this parameter is set to
  4289.             SLOW.  If you have a normal IBM PC with good DMA chip, set this
  4290.             parameter to FAST.
  4291.      PC= The Pacing Character.  This is the character echoed by the host at
  4292.             the  end of each line.  If you set this character,  the program
  4293.             will wait for it to be echoed by the host at the  end  of  each
  4294.             line  during  an  ASCII  file  transmission.  The default is no
  4295.             Pacing Character.  The abbreviations CR and LF may be  used  in
  4296.             this  field  to  indicate  the  carriage  return  and  linefeed
  4297.             characters, as well as the | character for carriage return.
  4298.      EL= End-of-Line Mode.  This determines the line terminating characters
  4299.             sent  to the host,  during ASCII file transmit,  to delimit the
  4300.             end-of-line.  Defaults to CRLF,  carriage return and  linefeed.
  4301.             The other options are LF,  only linefeed, and CR, only carriage
  4302.             return.
  4303.      AD= ASCII  inter-character  delay.  Specified  in  milliseconds.   The
  4304.             default value is 0.
  4305.  
  4306.  
  4307.                                    - 73 -
  4308.  
  4309.  
  4310.      WF= Window  foreground color number.  Anyone of the 16 values from the
  4311.             table below.
  4312.      WB= Window background color number.  Anyone of the DARK shades, 0-7,
  4313.             from the table below.
  4314.      WR= Window-frame foreground color number.  Anyone  of  the  16  values
  4315.             from the table below.
  4316.      WS= Window-frame  background  color number.  Anyone of the DARK shades
  4317.             from the table below.
  4318.      HF= Option hi-lite color, foreground.
  4319.      HB= Option hi-lite color, background.
  4320.      OF= Option lo-lite color, foreground.
  4321.      OB= Option lo-lite color, background.
  4322.      TF= Status line color, foreground.
  4323.      TB= Status line color, background.
  4324.      WU= Window Title color, foreground.
  4325.      WV= Window Title color, background.
  4326.      DU= Phone directory hi-lite color, foreground.
  4327.      DV= Phone directory hi-lite color, background.
  4328.      CR= Chat foreground.  For remote caller.
  4329.      CF= Chat foreground.  For local sysop.
  4330.      LG= If TRUE,  GT will keep  a  log  of  all  BBS's  called  and  files
  4331.             transferred.  Default is FALSE.
  4332.      PD= Current phone directory name.  Default is 'GT'.
  4333.      SB= Minutes  of  inactivity until the screen is blanked.  A value of 0
  4334.             disables the screen blanker.
  4335.      CK= If TRUE,  GT will automatically check diskspace available prior to
  4336.             downloading  any  file.  If FALSE,  GT will not check diskspace
  4337.             before downloads.
  4338.      MM= If FALSE,  GT will not play music received from the  host  system.
  4339.             If TRUE,  the music will be played.  If emulation mode is TRUE,
  4340.             this switch is forced to be FALSE.
  4341.      RC= Result  codes.  The  code  is  defined by the numeric code and the
  4342.             code actually returned by the  modem.  There  are  17  possible
  4343.             codes, only 15 of which are used.  Example: RC=1,CONNECT
  4344.      SO= Bios video routines.  If TRUE,  the Bios video  routines  will  be
  4345.             used  my  the window handler,  instead of direct memory access.
  4346.             The Bios routines are much slower,  but  have  the  benefit  of
  4347.             compatibility with multi-tasking operating systems.
  4348.      PG= Pagination of printer output.  If TRUE,  the output on the printer
  4349.             will  be  paginated,   so  that  it  doesn't   print   on   the
  4350.             perforations.
  4351.      LP= Lines per page.  Works with the pagination option.
  4352.      KY= Name of the current macro key file.  Default is 'GT'.
  4353.      BS= Swap  position  of  BackSpace  and  Del  keys,  used  with  VT-100
  4354.             emulation.
  4355.      BL= BREAK length in milliseconds.
  4356.      TL= Tilde  length.  The tilde ~ is used to add delay to various string
  4357.             sent to the modem.
  4358.      HN= Off-hook string.  Sent to modem to make it go off-hook.
  4359.      HY= On-hook string.  Sent to modem to make it go on-hook.
  4360.      NK= Option to make NO KILL the default message security.
  4361.      SM= Message path for M)essages to the SYSOP.
  4362.      DD= The default file directory.  The one callers first see  when  they
  4363.             connect.
  4364.  
  4365.  
  4366.                                    - 74 -
  4367.  
  4368.  
  4369.      LO= Log file path.  The log will be stored in this directory.
  4370.      CL= Capture memory buffer limit in 1,000s of characters.
  4371.      BP= Blank  pad  mode.  Used  to control the sending of blanks lines in
  4372.             ASCII transmit mode.  If TRUE,  then blank lines will be padded
  4373.             with blanks.  Helps with message upload to BBSs.
  4374.      EW= Exploding windows option.  If TRUE, then GT's windows will explode
  4375.             when they open.
  4376.      AR= Auto  redial  on  BUSY  result  from  modem.  If  TRUE,  GT's will
  4377.             automatically redial a number that is BUSY when dialed from the
  4378.             phone directory.
  4379.      E0= External protocol definition #1.
  4380.      E1= External protocol definition #2.
  4381.      E2= External protocol definition #3.
  4382.      E3= External protocol definition #4.
  4383.      E4= External protocol definition #5.
  4384.      E5= External protocol definition #6.
  4385.      E6= External protocol definition #7.
  4386.      E7= External protocol definition #8.
  4387.      E8= External protocol definition #9.
  4388.      E9= External protocol definition #10.
  4389.      EA= External protocol definition #11.
  4390.      EB= External protocol definition #12.
  4391.      EC= External protocol definition #13.
  4392.      EE= External protocol definition #14.
  4393.      EF= External protocol definition #15.
  4394.      EG= External protocol definition #16.
  4395.  
  4396.      * = Comment lines.
  4397.  
  4398.      Note:  These entries may either be changed via the Alt-I  command,  or
  4399.             with  any text editor that produces standard ASCII files,  such
  4400.             as EDLIN.
  4401.  
  4402.  
  4403.  
  4404.  
  4405.  
  4406.  
  4407.  
  4408.  
  4409.  
  4410.  
  4411.  
  4412.  
  4413.  
  4414.  
  4415.  
  4416.  
  4417.  
  4418.  
  4419.  
  4420.  
  4421.  
  4422.  
  4423.  
  4424.  
  4425.                                    - 75 -
  4426.  
  4427.  
  4428.      Configuration File Defaults
  4429.      ---------------------------
  4430.      CM=1
  4431.      ST=1
  4432.      DA=8
  4433.      PA=0
  4434.      SR=FALSE
  4435.      BA=1200
  4436.      LB=300
  4437.      MB=19200
  4438.      CS=FALSE
  4439.      RS=FALSE
  4440.      CL=16
  4441.      P0=
  4442.      P1=
  4443.      P2=
  4444.      P3=
  4445.      P4=
  4446.      P5=
  4447.      P6=
  4448.      P7=
  4449.      S2=
  4450.      S3=
  4451.      S4=
  4452.      S5=
  4453.      S6=
  4454.      S7=
  4455.      S8=
  4456.      S9=
  4457.      S1=
  4458.      PR=ATDT
  4459.      HU=~+++~ATH|
  4460.      PF=
  4461.      P+=
  4462.      P*=
  4463.      P!=
  4464.      PO=|
  4465.      MI=AT V1 Q0 E0 X1 S0=0 S2=43|
  4466.      SY=
  4467.      SN=
  4468.      RT=90
  4469.      HY=ATH0|
  4470.      HN=ATH1|
  4471.      FC=FALSE
  4472.      AR=TRUE
  4473.      CT=60
  4474.      DP=C:\GT
  4475.      TP=
  4476.      UP=
  4477.      SP=
  4478.      LN=0
  4479.      LD=
  4480.      LR=
  4481.      E0=J,N,N,N,JM,Jmodem
  4482.  
  4483.  
  4484.                                    - 76 -
  4485.  
  4486.  
  4487.      E1=K,Y,N,N,KR,Kermit
  4488.      E2=Z,Y,N,N,ZM,Zmodem
  4489.      E3=G,Y,N,N,YG,Ymodem-G
  4490.      E4=I,Y,Y,Y,BI,BiModem
  4491.      E5= , , , ,  ,
  4492.      E6= , , , ,  ,
  4493.      E7= , , , ,  ,
  4494.      E8= , , , ,  ,
  4495.      E9= , , , ,  ,
  4496.      EA= , , , ,  ,
  4497.      EB= , , , ,  ,
  4498.      EC= , , , ,  ,
  4499.      EE= , , , ,  ,
  4500.      EF= , , , ,  ,
  4501.      EG= , , , ,  ,
  4502.      LF=FALSE
  4503.      LO=C:\GT
  4504.      TL=1000
  4505.      BL=250
  4506.      CP=C:\GT
  4507.      XO=17
  4508.      XF=19
  4509.      VT=FALSE
  4510.      EW=FALSE
  4511.      WN=FALSE
  4512.      SO=MIXED
  4513.      FG=7
  4514.      BG=0
  4515.      CC=;
  4516.      MX=8
  4517.      PC=
  4518.      EL=CR
  4519.      BP=FALSE
  4520.      WF=2
  4521.      WB=0
  4522.      WR=1
  4523.      WS=1
  4524.      WU=14
  4525.      WV=4
  4526.      DU=11
  4527.      DV=0
  4528.      CR=11
  4529.      CF=2
  4530.      HF=14
  4531.      HB=0
  4532.      OF=6
  4533.      OB=0
  4534.      TF=3
  4535.      TB=6
  4536.      LG=FALSE
  4537.      AD=0
  4538.      ED=0
  4539.      PD=GT
  4540.      DM=FAST
  4541.  
  4542.  
  4543.                                    - 77 -
  4544.  
  4545.  
  4546.      FD=FALSE
  4547.      MM=TRUE
  4548.      LP=60
  4549.      KY=GT
  4550.      BS=FALSE
  4551.      AW=TRUE
  4552.      CK=TRUE
  4553.      SB=0
  4554.      AS=ATA|
  4555.      PG=FALSE
  4556.      MP=C:\GT
  4557.      DD=C:\GT
  4558.      HO=AT V1 Q0 E0 M0 X1 S0=1 S2=255|
  4559.      NK=TRUE
  4560.      SM=C:\GT
  4561.      RC=0,0,OK
  4562.      RC=1,1,CONNECT
  4563.      RC=2,2,RING
  4564.      RC=3,3,NO CARRIER
  4565.      RC=4,4,ERROR
  4566.      RC=5,5,CONNECT 1200
  4567.      RC=6,6,NO DIAL TONE
  4568.      RC=7,7,BUSY
  4569.      RC=8,8,NO ANSWER
  4570.      RC=9,9,CONNECT 4800
  4571.      RC=10,10,CONNECT 2400
  4572.      RC=11,11,RINGING
  4573.      RC=12,12,VOICE
  4574.      RC=13,13,CONNECT 9600
  4575.      RC=14,14,CONNECT 4800/ARQ
  4576.      RC=15,15,CONNECT 1200/ARQ
  4577.      RC=16,16,CONNECT 2400/ARQ
  4578.      RC=17,17,CONNECT 9600/ARQ
  4579.      RC=18,18,CONNECT 19200/ARQ
  4580.  
  4581.  
  4582.  
  4583.  
  4584.  
  4585.  
  4586.  
  4587.  
  4588.  
  4589.  
  4590.  
  4591.  
  4592.  
  4593.  
  4594.  
  4595.  
  4596.  
  4597.  
  4598.  
  4599.  
  4600.  
  4601.  
  4602.                                    - 78 -
  4603.  
  4604.  
  4605.                             Color Number Table:
  4606.                             -------------------
  4607.  
  4608.                      Dark Colors         Light Colors
  4609.                      -----------         ------------
  4610.                      0 : Black           8  : Dark Gray
  4611.                      1 : Blue            9  : Light Blue
  4612.                      2 : Green           10 : Light Green
  4613.                      3 : Cyan            11 : Light Cyan
  4614.                      4 : Red             12 : Light Red
  4615.                      5 : Magenta         13 : Light Magenta
  4616.                      6 : Brown           14 : Yellow
  4617.                      7 : Light Gray      15 : White
  4618.  
  4619.  
  4620.  
  4621.  
  4622.  
  4623.  
  4624.  
  4625.  
  4626.  
  4627.  
  4628.  
  4629.  
  4630.  
  4631.  
  4632.  
  4633.  
  4634.  
  4635.  
  4636.  
  4637.  
  4638.  
  4639.  
  4640.  
  4641.  
  4642.  
  4643.  
  4644.  
  4645.  
  4646.  
  4647.  
  4648.  
  4649.  
  4650.  
  4651.  
  4652.  
  4653.  
  4654.  
  4655.  
  4656.  
  4657.  
  4658.  
  4659.  
  4660.  
  4661.                                    - 79 -
  4662.  
  4663.  
  4664.      ANSI Emulation - Received Characters
  4665.      ------------------------------------
  4666.      Cursor Up .................................. ESC [ Pn A
  4667.      Cursor Down ................................ ESC [ Pn B
  4668.      Cursor Forward ............................. ESC [ Pn C
  4669.      Cursor Backward ............................ ESC [ Pn D
  4670.      Cursor Position ............................ ESC [ Pl ; Pc H
  4671.      Cursor Position (Home) ..................... ESC [ H
  4672.      Horizontal and Vertical Position ........... ESC [ Pl ; Pc f
  4673.      Horizontal and Vertical Position (Home) .... ESC [ f
  4674.      Set Scrolling Region ....................... ESC [ Pt ; Pb r
  4675.      Set Origin Mode ......see notes below....... ESC [ ? 6 h
  4676.      Reset Origin Mode .......................... ESC [ ? 6 l
  4677.      Index ...................................... ESC D
  4678.      Reverse Index .............................. ESC M
  4679.      Reverse Linefeed ........................... ESC I
  4680.      Next Line .................................. ESC E
  4681.      Save Cursor ................................ ESC 7
  4682.                                                or ESC [ s
  4683.      Restore Cursor ............................. ESC 8
  4684.                                                or ESC [ u
  4685.      Cursor Key Mode Set ........................ ESC [ ? 1 h
  4686.      Application Keypad Mode .................... ESC =
  4687.      Cursor Key Mode Reset ...................... ESC [ ? 1 l
  4688.      Numeric Keypad Mode ........................ ESC >
  4689.      Select US Character Set .................... ESC ( B
  4690.      Select Line Drawing Character Set .......... ESC ( 0
  4691.      Turn Off Character Attributes .............. ESC [ m
  4692.      Selects Bold Characters .................... ESC [ 1 m
  4693.      Selects Underlined Characters .............. ESC [ 4 m
  4694.      Selects Blinking Characters ................ ESC [ 5 m
  4695.      Selects Reverse Video Characters ........... ESC [ 7 m
  4696.      Set Horizontal Tab Stop .................... ESC H
  4697.      Clear A Horizontal Tab Stop ................ ESC [ g
  4698.      Clear All Horizontal Tab Stops ............. ESC [ 3 g
  4699.      Erase From Cursor To End Of Line ........... ESC [ K
  4700.      Erase From Beginning Of Line To Cursor ..... ESC [ 1 K
  4701.      Erase Complete Line ........................ ESC [ 2 K
  4702.      Erase From Cursor To End Of Screen ......... ESC [ J
  4703.      Erase From Beginning Of Screen To Cursor ... ESC [ 1 J
  4704.      Erase Complete Display ..................... ESC [ 2 J
  4705.      Delete Character At Cursor ................. ESC [ Pn P
  4706.      Insert Line At Cursor ...................... ESC [ Pn L
  4707.      Delete Line At Cursor ...................... ESC [ Pn M
  4708.      Select Insert Mode ......................... ESC [ 4 h
  4709.      Reset Insert Mode .......................... ESC [ 4 l
  4710.      Select Newline Mode ........................ ESC [ 20 h
  4711.      Reset Newline Mode ......................... ESC [ 20 l
  4712.      Select Auto Line Wrap Mode ................. ESC [ ? 7 h
  4713.      Reset Auto Line Wrap Mode .................. ESC [ ? 7 l
  4714.      Turn Printer On ............................ ESC [ ? 5 i
  4715.      Turn Printer Off ........................... ESC [ ? 4 i
  4716.      Turn Printer Controller On ................. ESC [ 5 i
  4717.      Turn Printer Controller Off ................ ESC [ 4 i
  4718.  
  4719.  
  4720.                                    - 80 -
  4721.  
  4722.  
  4723.      Print Screen ............................... ESC [ i
  4724.      Request Cursor Position Report ............. ESC [ 6 n
  4725.             Response: Cursor Position Report .... ESC [ Pl ; Pc R
  4726.      Request ID ................................. ESC [ c
  4727.             Response: VT102 ..................... ESC [ ? 6 c
  4728.  
  4729.      Notes:
  4730.  
  4731.          ESC is used to represent the  escape  character,  decimal  27.  Pn
  4732.          represents  a  variable  numeric  parameter,  the  parameter  is a
  4733.          decimal  number  transmitted  to  the  program  by   using   ASCII
  4734.          characters.  Pl represents the LINE, and Pc represents the COLUMN,
  4735.          these  are  numeric  parameters  sent  using ASCII characters.  Pt
  4736.          represents the TOP LINE of a scrolling region,  and Pb  represents
  4737.          the  BOTTOM  LINE  of  a  scrolling  region,   these  are  numeric
  4738.          parameters sent using ASCII characters.  The spaces shown are  for
  4739.          readability, they are not sent by the host.
  4740.  
  4741.          When "Origin Mode" is set, the cursor is confined to the scrolling
  4742.          region.  Whenever  a change takes place in the "Origin Mode",  the
  4743.          cursor is moved to the home position.  The cursor is also moved to
  4744.          the home position whenever a  change  is  made  in  the  scrolling
  4745.          region.
  4746.  
  4747.  
  4748.  
  4749.  
  4750.  
  4751.  
  4752.  
  4753.  
  4754.  
  4755.  
  4756.  
  4757.  
  4758.  
  4759.  
  4760.  
  4761.  
  4762.  
  4763.  
  4764.  
  4765.  
  4766.  
  4767.  
  4768.  
  4769.  
  4770.  
  4771.  
  4772.  
  4773.  
  4774.  
  4775.  
  4776.  
  4777.  
  4778.  
  4779.                                    - 81 -
  4780.  
  4781.  
  4782.      ANSI Emulation - Transmitted Characters
  4783.      ---------------------------------------
  4784.      Function Keys .............................. User Programmable.
  4785.      End ........................................ ESC O R
  4786.      Ctrl-End ................................... ESC O S
  4787.      Del ........................................ DEL
  4788.      Ins ........................................ ESC O n
  4789.      Home ....................................... ESC [ H
  4790.      PgUp ....................................... ESC [ O r
  4791.      PgDn ....................................... ESC [ O q
  4792.      Shift-Tab .................................. ESC [ O x
  4793.      Left Arrow ................Normal........... ESC [ C
  4794.                                 Keypad Mode...... ESC O C
  4795.      Right Arrow ...............Normal........... ESC [ D
  4796.                                 Keypad Mode...... ESC O D
  4797.      Up Arrow ..................Normal........... ESC [ A
  4798.                                 Keypad Mode...... ESC O A
  4799.      Down Arrow ................Normal........... ESC [ B
  4800.                                 Keypad Mode...... ESC O B
  4801.      Others ..................................... Standard Values.
  4802.  
  4803.      Note: The blanks are included for readability only.
  4804.  
  4805.  
  4806.  
  4807.  
  4808.  
  4809.  
  4810.  
  4811.  
  4812.  
  4813.  
  4814.  
  4815.  
  4816.  
  4817.  
  4818.  
  4819.  
  4820.  
  4821.  
  4822.  
  4823.  
  4824.  
  4825.  
  4826.  
  4827.  
  4828.  
  4829.  
  4830.  
  4831.  
  4832.  
  4833.  
  4834.  
  4835.  
  4836.  
  4837.  
  4838.                                    - 82 -
  4839.  
  4840.  
  4841.      Support For USRobotics Courier 2400
  4842.      -----------------------------------
  4843.      Here are the proper switch settings for the Courier modem:
  4844.  
  4845.      Switch    Setting
  4846.      ------    -------
  4847.        1       UP,  Normal  DTR.  This  is  not the factory setting,  so it
  4848.                should be changed by the user.  GT requires this setting for
  4849.                proper operation of the host  mode.  In  terminal  mode,  GT
  4850.                does  not  require  this  switch setting.  Instead,  you can
  4851.                specify a hang-up string in the configuration area.
  4852.  
  4853.        2       Doesn't matter to GT.  Use the Vn command in the modem  init
  4854.                strings to get proper setting.
  4855.  
  4856.        3       DOWN, Result Codes are displayed.
  4857.  
  4858.        4       DOWN,  No Command Echo.  Again,  this is preferred,  but not
  4859.                required.
  4860.  
  4861.        5       Doesn't matter to GT.
  4862.  
  4863.        6       UP,  carrier detect signal is  present  only  when  on-line.
  4864.                This is not the factory setting and should be changed by the
  4865.                user.
  4866.  
  4867.        7       Doesn't matter to GT.
  4868.  
  4869.        8       DOWN, Use Normal AT commands.
  4870.  
  4871.        9       Doesn't matter to GT.
  4872.  
  4873.        10      Doesn't matter to GT.
  4874.  
  4875.        Quad Switch
  4876.                UP, Use Normal Pin Assignments.
  4877.  
  4878.  
  4879.  
  4880.  
  4881.  
  4882.  
  4883.  
  4884.  
  4885.  
  4886.  
  4887.  
  4888.  
  4889.  
  4890.  
  4891.  
  4892.  
  4893.  
  4894.  
  4895.  
  4896.  
  4897.                                    - 83 -
  4898.  
  4899.  
  4900.  
  4901.      USRobotics Courier HST, 9600 Baud Modem Support.
  4902.      ------------------------------------------------
  4903.      The switch settings for the HST modem are much the same as the Courier
  4904.      2400  baud  modem  above,  so  I  will  not  discuss  them.  The  main
  4905.      difference between these two modems falls into three catagories:
  4906.  
  4907.      1.   Init String Usage.
  4908.  
  4909.           The HST modem supports a variety of  '&'  commands  that  can  be
  4910.           placed into the init string.  The standard values for use with GT
  4911.           are &M4,  &H1, and &B0.  These values should be added both to the
  4912.           terminal and host mode init strings.
  4913.  
  4914.      2.   Configuration Setup.
  4915.  
  4916.           When used with any modem that uses MNP or  ARQ  error  correction
  4917.           technology,  GT  should have the "Honor CTS from modem" parameter
  4918.           set = TRUE.  In this way,  GT will stop sending data to the modem
  4919.           when the CTS signal is lowered.
  4920.  
  4921.      3.   19200 Baud Rate.
  4922.  
  4923.           When  using the 19200 baud rate,  GT will not fallback to a lower
  4924.           rate at CONNECT time.  This means that the init strings  must  be
  4925.           changed to include &B1,  which signals the modem that the cpu-to-
  4926.           modem rate is being held constant.  This is extremely useful when
  4927.           optimum thru-put is required.  However,  take note  that  GT  may
  4928.           overrun  the  receiving  computer at 9600 baud.  GT is capable of
  4929.           sending at the very highest rates your computer is capable of and
  4930.           if the remote computer cannot accept the data at the higher rate,
  4931.           an overrun condition may arise.  GT will try  to  avoid  this  by
  4932.           respecting  any  XON/XOFF signal sent by remote during a MegaLink
  4933.           file transfer (when the danger of overrun is the highest).
  4934.  
  4935.      4.   Fixed DTE operation.
  4936.  
  4937.           When operating a high speed modem, it is quite often desirable to
  4938.           optimize performance by forcing the computer to operate at a high
  4939.           fixed  baud  rate,  while  the  modem(DCE)  rate floats with each
  4940.           connection.  GT supports this capability through the use of three
  4941.           configuration parameters:  Fixed DTE,  CTS Flow Control,  and RTS
  4942.           Flow  Control.  These  parameters  are  located  under #30 of the
  4943.           Alt÷I configuration screen.  When using these  options,  be  sure
  4944.           that  the  modem  is also set to use a compatible operating mode.
  4945.           The RTS flow control will be used during file transfers,  when GT
  4946.           is  going  to  write  a  block to the disk,  GT will drop the RTS
  4947.           signal to the modem,  then write to the  disk,  raising  the  RTS
  4948.           signal afterward.  The CTS signal is used by the modem to stop GT
  4949.           from  transmitting  when  the  modem's buffer is nearly full.  GT
  4950.           will resume transmission once the CTS  signal  is  raised  again.
  4951.           The  Fixed  DTE does not "freeze" the baud rate,  rather the baud
  4952.           rate is selected in the normal manner (usually from the value  in
  4953.           the  dialing  directory),  rather  the  Fixed  DTE  keeps GT from
  4954.  
  4955.  
  4956.                                    - 84 -
  4957.  
  4958.  
  4959.           shifting to the DCE rate upon connection.  If you wish to have  a
  4960.           frozen baud rate,  you can set the minimum and maximum baud rates
  4961.           in the program's configuration to the desired value.  This  would
  4962.           result in a frozen baud rate.
  4963.  
  4964.  
  4965.  
  4966.  
  4967.  
  4968.  
  4969.  
  4970.  
  4971.  
  4972.  
  4973.  
  4974.  
  4975.  
  4976.  
  4977.  
  4978.  
  4979.  
  4980.  
  4981.  
  4982.  
  4983.  
  4984.  
  4985.  
  4986.  
  4987.  
  4988.  
  4989.  
  4990.  
  4991.  
  4992.  
  4993.  
  4994.  
  4995.  
  4996.  
  4997.  
  4998.  
  4999.  
  5000.  
  5001.  
  5002.  
  5003.  
  5004.  
  5005.  
  5006.  
  5007.  
  5008.  
  5009.  
  5010.  
  5011.  
  5012.  
  5013.  
  5014.  
  5015.                                    - 85 -
  5016.  
  5017.  
  5018.      Hayes 2400 Initialization String
  5019.      --------------------------------
  5020.      The Hayes 2400 baud modems do not have any switches that  need  to  be
  5021.      set on the board with the exception of the port select switch which is
  5022.      accessible  on the end plate itself.  All settings that would normally
  5023.      be set by switches are program selectable and,  once set,  they may be
  5024.      stored into a writable ROM on the card itself for further use.
  5025.  
  5026.      Following  is  the  Modem Initialization string that has been found to
  5027.      work with GT POWER:
  5028.  
  5029.                          ATE0V0X4S0=0L2S2=43&C1&D2M1|
  5030.  
  5031.      The above string may have embedded blanks without affect.
  5032.  
  5033.      Following  is  the Host Mode Initialization string that has been found
  5034.      to work with GT POWER:
  5035.  
  5036.                          AT V0 Q0 E0 X4 S0=0 S2=255 M0|
  5037.  
  5038.      The above settings show the use  of  'TERSE'  result  codes  from  the
  5039.      modem.  As  was  pointed out in an earlier part of this documentation,
  5040.      'VERBOSE' result codes are preferable.  The  use  of  TERSE  mode  (as
  5041.      selected  by  setting  V0 rather than V1) was shown here to give you a
  5042.      complete picture of both ways of setting up your system.  The standard
  5043.      (default) result code table  distributed  with  GT  POWER  can  handle
  5044.      either VERBOSE or TERSE codes.
  5045.  
  5046.  
  5047.  
  5048.  
  5049.  
  5050.  
  5051.  
  5052.  
  5053.  
  5054.  
  5055.  
  5056.  
  5057.  
  5058.  
  5059.  
  5060.  
  5061.  
  5062.  
  5063.  
  5064.  
  5065.  
  5066.  
  5067.  
  5068.  
  5069.  
  5070.  
  5071.  
  5072.  
  5073.  
  5074.                                    - 86 -
  5075.  
  5076.  
  5077.      Modem Setting Strings for IBM Modems
  5078.      ------------------------------------
  5079.  
  5080.                           Baud           String
  5081.                           ----           ------
  5082.                            300           <Ctrl-N>SP 2|
  5083.                           1200           <Ctrl-N>SP 4|
  5084.  
  5085.      I do not know what the string should be for people who have  IBM  2400
  5086.      baud modem, but I suspect it would be: <Ctrl-N>SP 5
  5087.  
  5088.                        Data Format        String
  5089.                        -----------        ------
  5090.                           7-N-1           <Ctrl-N>FO 0|
  5091.                           7-M-1           <Ctrl-N>FO 1|
  5092.                           7-E-1           <Ctrl-N>FO 4|
  5093.                           7-O-1           <Ctrl-N>FO 3|
  5094.                           8-N-1           <Ctrl-N>FO 5|
  5095.                           8-M-1           <Ctrl-N>FO 6|
  5096.                           8-E-1           <Ctrl-N>FO 9|
  5097.                           8-O-1           <Ctrl-N>FO 8|
  5098.  
  5099.  
  5100.  
  5101.  
  5102.  
  5103.  
  5104.  
  5105.  
  5106.  
  5107.  
  5108.  
  5109.  
  5110.  
  5111.  
  5112.  
  5113.  
  5114.  
  5115.  
  5116.  
  5117.  
  5118.  
  5119.  
  5120.  
  5121.  
  5122.  
  5123.  
  5124.  
  5125.  
  5126.  
  5127.  
  5128.  
  5129.  
  5130.  
  5131.  
  5132.  
  5133.                                    - 87 -
  5134.  
  5135.  
  5136.      Registration Message
  5137.      --------------------
  5138.      Dear GT User:                                                 12-8-90
  5139.  
  5140.      I know you are asking yourself,  "Why should I send a contribution for
  5141.      GT"?  Here are a few answers.
  5142.  
  5143.      1.   The shareware copy of GT has a delay at the start of the program.
  5144.           When you register you will receive a key that will allow  an  you
  5145.           to enter the program quickly.
  5146.  
  5147.      2.   You  will  receive a registered copy of GT,  with your own serial
  5148.           number.  If you distribute GT,  and someone registers your serial
  5149.           number, you will get a split of the contribution.  For every copy
  5150.           registered  with your serial number,  you will receive 25% of the
  5151.           amount tendered.
  5152.  
  5153.      3.   You  will  receive  a copy of "Turbo CALC".  This is the powerful
  5154.           spreadsheet program from P & M Software Co.
  5155.  
  5156.      4.   You will receive copies of the latest GT netmail programs,  which
  5157.           will  allow  you  to  pass  electronic  mail along the GT netmail
  5158.           system.  NOTE:  the GT netmail programs are not shareware and can
  5159.           only be obtained thru registration of GT.
  5160.  
  5161.      5.   Phone support is available to registered users,  have your serial
  5162.       number handy when you call.  The number  is  602-897-9557  voice,
  5163.       or  602-897-9549 modem.   The modem line is open 24 hours  a day, 
  5164.       the voice line is  available during  normal office hours,  8-5 pm 
  5165.       Mountain Standard Time.
  5166.  
  5167.      6.   A  key will be provided to registered users,  so that the opening
  5168.           copyright screen will remove itself automatically.  In the spirit
  5169.           of shareware,  we ask that the  key  not  be  disclosed  to  non-
  5170.           registered users.
  5171.  
  5172.      7.   You  will  receive  an  alive  program,  supported by its author.
  5173.           Continued support of GT or any  other  "User  Supported"  program
  5174.           depends  on the financial support of its users.  Pure survival of
  5175.           the best and fittest.
  5176.  
  5177.      To show our intention to support our products,  we are proud to  offer
  5178.      our new customers a 30 day money back guarantee.
  5179.  
  5180.      If you wish to register,  or if you are already registered and wish to
  5181.      upgrade to the latest version of GT,  please fill out and  return  the
  5182.      following form:
  5183.  
  5184.  
  5185.  
  5186.  
  5187.  
  5188.  
  5189.  
  5190.  
  5191.  
  5192.                                    - 88 -
  5193.  
  5194.   +-----------------------------------------------------------------------+
  5195.   |                                                                       |
  5196.   |                              GT POWER                                 |
  5197.   |                          Registration Form                            |
  5198.   |                                                                       |
  5199.   |                                                                       |
  5200.   |   Date: __________                    TO:  P & M Software Co.         |
  5201.   |                                            3104 E. Camelback Rd.      |
  5202.   |                                            #503                       |
  5203.   |                                            Phoenix, AZ 85016          |
  5204.   |                                            U.S.A.                     |
  5205.   |                                                                       |
  5206.   |   FROM:     Name: ________________________________________            |
  5207.   |                                                                       |
  5208.   |          Address: ________________________________________            |
  5209.   |                                                                       |
  5210.   |                   ________________________________________            |
  5211.   |                                                                       |
  5212.   |                   ________________________________________            |
  5213.   |                                                                       |
  5214.   |          Work Phone # (_____)_______________________                  |
  5215.   |                                                                       |
  5216.   |          Home Phone # (_____)_______________________                  |
  5217.   |                                                                       |
  5218.   |                                                                       |
  5219.   |   CHECK VERSION(S) OF GT POWER WANTED:                                |
  5220.   |      1 selection no extra charge, additional selections, $7 each.     |
  5221.   |                                                                       |
  5222.   |   15.50  16.00  17.00                                                 |
  5223.   |   =====  =====  =====                                                 |
  5224.   |                                                                       |
  5225.   |   _____  _____  _____  PC/XT and clones.                              |
  5226.   |                                                                       |
  5227.   |   _____  _____  _____  PC/XT and clones, overlay version.             |
  5228.   |                        Uses less memory, runs slower as a result.     |
  5229.   |                                                                       |
  5230.   |   _____  _____  _____  AT/286 and clones.  Optimized for 286/386.     |
  5231.   |                                                                       |
  5232.   |   _____  _____  _____  Rapid version.  PC/XT/AT and clones.           |
  5233.   |                        Fastest, tightest code of all versions.        |
  5234.   |                        But not compatible with all systems.  Try it   |
  5235.   |                        first, before ordering.                        |
  5236.   |                                                                       |
  5237.   |   _____                FOSSIL version, Victor 9000, Tandy 2000, etc.  |
  5238.   |                                                                       |
  5239.   |                                                                       |
  5240.   |   NOTE: Each selection above includes copies of GT and GTO.           |
  5241.   |                                                                       |
  5242.   |                                                                       |
  5243.   |   CHECK DESIRED SELECTION(S):                                         |
  5244.   |                                                                       |
  5245.   |   ____ Initial registration of GT POWER 17.00.                        |
  5246.   |           $70 U.S. suggested price for version 17.00.                 |
  5247.   |                                                                       |
  5248.   |   ____ Initial registration of GT POWER 16.00.                        |
  5249.   |           $55 U.S. suggested price for version 16.00                  |
  5250.   |                                                                       |
  5251.   |   ____ Initial registration of GT POWER 15.50.                        |
  5252.   |           $40 U.S. suggested price for version 15.50                  |
  5253.   |                                                                       |
  5254.   |   ____ Upgrade from 16.00 to 17.00 of GT POWER, $20 U.S.              |
  5255.   |                                                                       |
  5256.   |   ____ Upgrade from 15.50 or earlier to 17.00 of GT POWER, $35 U.S.   |
  5257.   |                                                                       |
  5258.   |   ____ Upgrade any prior version to 16.00 of GT POWER, $20 U.S.       |
  5259.   |                                                                       |
  5260.   |   ____ Enter standing order.  Available to credit card customers.     |
  5261.   |           All releases sent automatically.  Fees are charged just     |
  5262.   |           before shipment of product.  Bug fixes will be charged      |
  5263.   |           a handling fee of $10, plus $5.00 postage for overseas.     |
  5264.   |           Feature release will be charged at $20 each, plus $5.00     |
  5265.   |           postage for overseas.                                       |
  5266.   |                                                                       |
  5267.   |                                                                       |
  5268.   |   PLEASE INDICATE SERIAL # AND VERSION OF PROGRAM YOU HAVE:           |
  5269.   |            (Press ALT-J to display serial number.)                    |
  5270.   |                                                                       |
  5271.   |            Serial # _____________        Version #  17.00             |
  5272.   |                                                                       |
  5273.   |                                                                       |
  5274.   |   PLEASE INDICATE AMOUNT ENCLOSED:                                    |
  5275.   |                                                                       |
  5276.   |            Base contribution amount .......... __________             |
  5277.   |                                                                       |
  5278.   |            Extra versions, add $7 per copy ... __________             |
  5279.   |               from check-list above.                                  |
  5280.   |                                                                       |
  5281.   |            For 3.5" diskettes, add $5 ........ __________             |
  5282.   |                                                                       |
  5283.   |            Outside NORTH AMERICA, add $5                              |
  5284.   |               for AIR MAIL postage ........... __________             |
  5285.   |                                                                       |
  5286.   |            Foreign Bank Draft Fee, add $7                             |
  5287.   |               for banks outside of U.S. ...... __________             |
  5288.   |                                                                       |
  5289.   |            Total Enclosed (U.S. DOLLARS) .....                        |
  5290.   |                                                ==========             |
  5291.   |                                                                       |
  5292.   |   PLEASE INDICATE METHOD OF PAYMENT:                                  |
  5293.   |                                                                       |
  5294.   |      If using credit card, please indicate your card no. and          |
  5295.   |      expiration date.  On MasterCard(r) include the Interbank No.     |
  5296.   |                                                                       |
  5297.   |   ___ MasterCard(r)   Interbank No.   _____________                   |
  5298.   |   ___ Visa                                                            |
  5299.   |   ___ Check           Credit Card No. ____________________________    |
  5300.   |   ___ Money Order                                                     |
  5301.   |                       Expiration Date _____________                   |
  5302.   |                                                                       |
  5303.   |                       Signature __________________________________    |
  5304.   |                                                                       |
  5305.   |                                                                       |
  5306.   |   Please DO NOT send cash.  Send check, money order, or credit card   |
  5307.   |   information.  Your request will be filled promptly upon receipt.    |
  5308.   |                                                                       |
  5309.   |   Customers residing outside of the United States of America should   |
  5310.   |   submit payment in the form of a check drawn in U.S. DOLLARS on a    |
  5311.   |   New York City bank or use one of the credit cards listed above.     |
  5312.   |                                                                       |
  5313.   +-----------------------------------------------------------------------+
  5314.  
  5315.  
  5316.                                 - THE END -
  5317.  
  5318.  
  5319.  
  5320.  
  5321.  
  5322.  
  5323.  
  5324.  
  5325.  
  5326.  
  5327.  
  5328.  
  5329.  
  5330.  
  5331.  
  5332.  
  5333.  
  5334.  
  5335.  
  5336.  
  5337.  
  5338.  
  5339.  
  5340.  
  5341.  
  5342.  
  5343.  
  5344.  
  5345.  
  5346.  
  5347.  
  5348.  
  5349.  
  5350.  
  5351.  
  5352.  
  5353.  
  5354.  
  5355.  
  5356.  
  5357.  
  5358.  
  5359.  
  5360.                                    - 91 -
  5361.  
  5362.  
  5363.  
  5364.  
  5365.  
  5366.  
  5367.  
  5368.  
  5369.  
  5370.  
  5371.  
  5372.  
  5373.  
  5374.  
  5375.  
  5376.  
  5377.  
  5378.  
  5379.  
  5380.  
  5381.  
  5382.  
  5383.  
  5384.  
  5385.  
  5386.  
  5387.  
  5388.  
  5389.  
  5390.  
  5391.  
  5392.  
  5393.  
  5394.  
  5395.  
  5396.  
  5397.  
  5398.  
  5399.  
  5400.  
  5401.  
  5402.  
  5403.  
  5404.  
  5405.  
  5406.  
  5407.  
  5408.  
  5409.  
  5410.  
  5411.  
  5412.  
  5413.  
  5414.  
  5415.  
  5416.  
  5417.  
  5418.  
  5419.                                    - 92 -
  5420.